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

CPI-C Calls

WinCPICSetEvent

Chapter 3312

WinCPICSetEvent

For Windows The application uses this function to associate an event handle with verb

completion for the speciﬁed conversation.

Function Call

VOID WINAPI WinCPICSetEvent (

unsigned char CM_PTR conversation_ID,

HANDLE CM_PTR event_handle,

CM_INT32 CM_PTR return_code

);

Supplied Parameters

The supplied parameters are:

conversation_ID

This is the identiﬁer for the conversation for which

this event is used. This parameter is returned by the

initial Accept_Conversation call.

event_handle

This is the handle of the event that is to be cleared

when an asynchronous verb on the conversation

completes. This parameter can replace an

already-deﬁned event or remove an already-deﬁned

event (by having NULL as the parameter).

Returned Parameters

return_code

Possible values are:

CM_OK The WinCPICSetEvent() function

executed successfully.

CM_PROGRAM_PARAMETER_CHECK One or more of the

parameters passed to this function

are invalid.