DbiGetObjFromObj

C syntax

DBIResult DBIFN DbiGetObjFromObj (hObj, eObjType, phObj);

Delphi syntax

function DbiGetObjFromObj (hObj: hDBIObj; eObjType: DBIOBJType; var hObj: hDBIObj): DBIResult stdcall;

Description

DbiGetObjFromObj returns an object of the specified object type associated with or derived from a given object.

Parameters

hObj Type: hDBIObj (Input)
Specifies the object.

eObjType Type: DBIOBJType (Input)
Specifies the type of object.

phObj Type: phDBIObj (Output)
Pointer to the object handle.

Usage

The following table summarizes the relationship between eObjType and hObj:

eObjType	Type of hObj allowed
objCURSOR	None
objDRIVER	objCURSOR, objDATABASE
objDATABASE	objCURSOR
objSESSION	objCURSOR, objDATABASE, NULL (active)
objCLIENT	Any or NULL
objSYSTEM	Any or NULL
objSTATEMENT	None

DbiResult	Meaning
DBIERR_NONE	The object handle was returned successfully.
DBIERR_INVALIDPARAM	phObj is NULL or hObj is invalid.
DBIERR_NA	No associated object.