WinCPICSetEvent
La funzione WinCPICSetEvent associa un handle di eventi a un completamento verbo.
Sintassi
VOID WINAPI WinCPICSetEvent(
unsigned char FAR* conversation_ID,HANDLE FAR* event_handle,
CM_INT32 FAR*return_code);
Parametri
conversation_ID
Specifica l'identificatore per la conversazione per cui viene usato questo evento. Questo parametro viene restituito dalla chiamata iniziale Accept_Conversation .
event_handle
Handle dell'evento da cancellare quando viene completato un verbo asincrono nella conversazione. Questo parametro può sostituire un evento già definito o rimuovere un evento già definito (con NULL come parametro).
return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.
Codici restituiti
CM_OK
La funzione è stata eseguita correttamente.
CM_PROGRAM_PARAMETER_CHECK
Uno o più parametri passati a questa funzione non sono validi.
CM_OPERATION_NOT_ACCEPTED
Questo valore indica che un'operazione precedente in questa conversazione è incompleta e la chiamata WinCPICSetEvent non è stata accettata.
Commenti
Quando un verbo viene rilasciato in una conversazione non sbloccata, restituisce CM_OPERATION_INCOMPLETE se verrà completato in modo asincrono. Se un evento è stato registrato con la conversazione, l'applicazione può chiamare WaitForSingleObject o WaitForMultipleObjects per ricevere una notifica del completamento del verbo. Al termine del verbo, l'applicazione deve chiamare Wait_For_Conversationper determinare il codice restituito per il verbo asincrono.
È responsabilità dell'applicazione reimpostare l'evento, come avviene con altre API.