Returns the client-side handle associated with a server-side handle.
DWORD dispFindHandle (CTAHD ctahd, unsigned svcid, unsigned value, CTAHD *ctaClntHd )
|
Argument |
Description |
|
ctahd |
Context handle. |
|
svcid |
Identifier of the service associated with the handle. |
|
value |
Value associated with the handle created by dispCreateHandle. |
|
ctaClntHd |
Pointer to the returned object handle. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_INVALID_HANDLE |
No object handle is associated with the specified arguments. |
|
CTAERR_NOT_INITIALIZED |
Natural Access was not initialized. |
dispFindHandle compares the service ID, the Natural Access context handle, and the value (for example: service object handle) to the values in the entries maintained in the dispatcher's internal handle mapping table. If an entry is found matching all these parameters, the entry's associated client-side handle is returned to the caller.
dispAttachHandle, dispDestroyHandle, dispFindHandleByName, dispGetHandleValue, dispGetHandleValueEx, dispSetHandleValue, dispSetHandleValueEx