Returns the client-side object handle associated with the named of service object.
DWORD dispFindHandleByName( CTAHD ctahd, unsigned svcid, char *name, CTAHD *ctaClntHd )
|
Argument |
Description |
|
ctahd |
Context handle. |
|
svcid |
Identifier of the service associated with the handle. |
|
name |
Pointer to the name of the service object. |
|
ctaClntHd |
Pointer to the returned client-side object handle. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_INVALID_CTAHD |
Object cannot be found. |
|
CTAERR_NOT_INITIALIZED |
Natural Access was not initialized. |
|
CTAERR_SVR_COMM |
Natural Access Server is not running. |
dispFindHandleByName compares the service ID, the context handle, and the service object name to the entries in the dispatcher's internal handle mapping table. If an entry is found matching all these values, the entry's associate client-side handle is returned to the caller.
dispAttachHandle, dispCreateHandle, dispDestroyHandle, dispFindHandle, dispGetHandleValue, dispGetHandleValueEx, dispSetHandleValue, dispSetHandleValueEx