# dispFindWaitObject

Returns a pointer to the internal dispatcher array entry containing the specified wait object.

#### Prototype

DWORD dispFindWaitObject (CTAQUEUEHD ctaQueueHd, CTA_WAITOBJ* pctaWaitObj, CTA_WAITOBJ** ppctaWaitObjFound)

Argument | Description
ctaQueueHd | Queue handle.
pctaWaitObj | Pointer to a wait object.
ppctaWaitObjFound | Pointer to the returned entry containing the wait object.

#### Return values

Return value | Description
SUCCESS |
CTAERR_BAD_ARGUMENT | Wait object is not associated with a queue.
CTAERR_INVALID_CTAQUEUEHD | ctaQueueHd is invalid.
CTAERR_NOT_INITIALIZED | Natural Access was not initialized.

#### Details

dispFindWaitObject returns the address of the internal array entry where the matching wait object is located. This function is currently needed for NMS's abstracted IPC communications layer (TSI library).