WinCPICExtractEvent

La funzione WinCPICExtractEvent fornisce un metodo per un'applicazione per determinare l'handle di evento utilizzato per una conversazione CPI-C (Common Programming Interface for Communications) di Microsoft® Windows®.

Sintassi

  
        VOID WINAPI WinCPICExtractEvent(   
unsigned char FAR*conversation_ID,HANDLE FAR*event_handle,    CM_INT32 FAR*return_code);  

Parametri

conversation_ID
Specifica l'identificatore per la conversazione per la quale viene utilizzato questo evento. Questo parametro viene restituito dalla chiamata iniziale Accept_Conversation .

event_handle
Parametro restituito. Handle dell'evento utilizzato da questa conversazione. Se non è stato registrato alcun handle, questo parametro restituisce un valore NULL.

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.

Commenti

Quando un verbo viene emesso in una conversazione non bloccante, 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. WinCPICExtractEvent consente a un'applicazione CPI-C di determinare questo handle di eventi. Al termine del verbo, l'applicazione deve chiamare Wait_For_Conversationper determinare il codice restituito per il verbo asincrono. La funzione Cancel_Conversationpuò essere chiamata per annullare un'operazione e una conversazione.

Se non è stato registrato alcun evento, il verbo asincrono viene completato così come lo è attualmente, ovvero pubblicando un messaggio nella finestra che l'applicazione ha registrato con la libreria CPI-C.