HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
WinCPICExtractEvent
Chapter 3314
WinCPICExtractEvent
For Windows The application uses this function to determine the event handle being
used for a CPI-C conversation.
Function Call
VOID WINAPI WinCPICExtractEvent (
unsigned char CM_PTR conversation_ID,
HANDLE CM_PTR event_handle,
CM_INT32 CM_PTR return_code
);
Supplied Parameters
The supplied parameter for this function is:
conversation_ID This is the identifier for the conversation for which
this event is used. This parameter is returned by the
initial Accept_Conversation call.
Returned Parameters
event_handle This is the handle of the event being used by this
conversation. If no handle has been registered, this
parameter returns a NULL value.
return_code Possible values are:
CM_OK The WinCPICExtractEvent()
function executed successfully.
CM_PROGRAM_PARAMETER_CHECK One or more of the
parameters passed to this function
are invalid.
Usage Notes
When a verb is issued on a nonblocking conversation, it returns
CM_OPERATION_INCOMPLETE if it is going to complete asynchronously. If
an event has been registered with the conversation, then the application
can call WaitForSingleObject() or WaitForMultipleObjects() to be