WinAsyncAPPCEx

La funzione WinAsyncAPPCEx fornisce un punto di ingresso asincrono per tutti i verbi APPC. Usare questa funzione anziché le versioni di blocco dei verbi per consentire la gestione di più sessioni nello stesso thread tramite eventi. Questo verbo è supportato solo in Microsoft Windows e usa eventi Win32®.

Sintassi

  
    HANDLE WINAPI WinAsyncAPPCEx(   
HANDLEevent_handle,  
longlpVcb);  

Parametri

event_handle
Handle usato per la notifica degli eventi tramite eventi Win32.

lpVcb
Puntatore al blocco di controllo verbo.

Valore restituito

Il valore restituito specifica se la richiesta di risoluzione asincrona ha avuto esito positivo. Se la funzione ha esito positivo, il valore restituito è un handle di attività asincrono. Se la funzione non ha esito positivo, viene restituito uno zero.

Quando questa funzione restituisce un valore con esito positivo, ciò non indica che la chiamata APPC restituirà correttamente. Indica solo che la libreria APPC può tentare la chiamata APPC in modo asincrono usando eventi per la notifica.

Commenti

Questa funzione è destinata all'uso con WaitForSingleObject o WaitForMultipleObjects nell'API Win32. Queste funzioni sono descritte nella sezione "Informazioni di riferimento" della documentazione di Microsoft Platform SDK.

Per un esempio di come usare questo verbo nei programmi di trasmissione multithreading, vedere l'esempio di programmi di trasmissione e ricezione multithread (MRCV). C, MSEND. C e MSENDRCV. C che si trova nella cartella MSENDRCV) inclusa nell'SDK.

I verbi APPC usati nelle conversazioni di base che possono essere bloccate sono i seguenti:

Nota

Le eccezioni al paragrafo precedente sono RECEIVE_AND_POST, MC_RECEIVE_AND_POST, RECEIVE_AND_WAIT e MC_RECEIVE_AND_WAIT.

Nota

Per consentire l'uso completo del supporto asincrono, i verbi RECEIVE_AND_WAIT e MC_RECEIVE_AND_WAIT emessi in modo asincrono sono stati modificati in modo da fungere da verbi RECEIVE_AND_POST e MC_RECEIVE_AND_POST asincroni. In particolare, mentre è in attesa una versione asincrona di uno di questi verbi, nella stessa conversazione possono essere rilasciati i verbi seguenti:

Nota

In questo modo un'applicazione, in particolare un'applicazione server, può usare un RECEIVE_AND_WAIT asincronoo MC_RECEIVE_AND_WAIT ricevere dati. Mentre il RECEIVE_AND_POST, MC_RECEIVE_AND_POST, RECEIVE_AND_WAIT o MC_RECEIVE_AND_WAIT è in sospeso, può comunque usare SEND_ERROR o MC_SEND_ERROR e REQUEST_TO_SEND oMC_REQUEST_TO_SEND. È consigliabile usare questa funzionalità per il supporto asincrono completo e, in particolare, per il supporto di più conversazioni nello stesso thread.

Al termine dell'operazione asincrona, l'applicazione viene notificata tramite la segnalazione dell'evento. Al momento della segnalazione dell'evento, esaminare il codice restituito primario APPC e il codice restituito secondario nel blocco di controllo verbo per eventuali condizioni di errore.