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 usando 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 usando 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 attività asincrono. Se la funzione non è riuscita, viene restituito uno zero.

Quando questa funzione restituisce un valore riuscito, questa operazione non indica che la chiamata APPC restituirà correttamente. Indica solo che è stato possibile che la libreria APPC tenti la chiamata appC in modo asincrono usando gli eventi per la notifica.

Commenti

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

Per un esempio di come usare questo verbo in TP multithreaded, vedere l'invio multithreaded e ricevere i TPS di esempio (MRCV). C, MSEND. C e MSENDRCV. C disponibile nella cartella MSENDRCV inclusa nell'SDK.

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

• ALLOCATE

• CONFERMARE

• CONFERMATO

• DEALLOCATE

• SCIACQUONE

• PREPARE_TO_RECEIVE

• RECEIVE_ALLOCATE

• RECEIVE_AND_WAIT

• REQUEST_TO_SEND

• SEND_CONVERSATION

• SEND_DATA

• SEND_ERROR

• TP_ENDED

• TP_STARTED

  I verbi APPC usati nelle conversazioni mappate che possono bloccare sono i seguenti:

• MC_ALLOCATE

• MC_CONFIRM

• MC_CONFIRMED

• MC_DEALLOCATE

• MC_FLUSH

• MC_PREPARE_TO_RECEIVE

• MC_RECEIVE_AND_WAIT

• MC_REQUEST_TO_SEND

• MC_SEND_CONVERSATION

• MC_SEND_DATA

• MC_SEND_ERROR

• RECEIVE_ALLOCATE

• TP_ENDED

• TP_STARTED

  Quando si usano le versioni sincrone o asincrone di un verbo, un'applicazione può avere una sola funzione in corso in una conversazione alla volta. Un tentativo di avviare una seconda funzione genera il codice di errore AP_CONV_BUSY.

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, RECEIVE_AND_WAIT e MC_RECEIVE_AND_WAIT verbi sono stati modificati per agire come i verbiRECEIVE_AND_POST e MC_RECEIVE_AND_POST. In particolare, mentre una versione asincrona di uno di questi verbi è in sospeso, i verbi seguenti possono essere rilasciati nella stessa conversazione:

• DEALLOCATE (AP_ABEND_PROG, AP_ABEND_SVC o AP_ABEND_TIMER)

• GET_ATTRIBUTES o MC_GET_ATTRIBUTES

• GET_TYPE

• REQUEST_TO_SEND o MC_REQUEST_TO_SEND

• SEND_ERROR o MC_SEND_ERROR

• TEST_RTS o MC_TEST_RTS

• TP_ENDED

Nota

Ciò consente a un'applicazione, in particolare, a un'applicazione server di usare un RECEIVE_AND_WAIT asincrono o MC_RECEIVE_AND_WAIT di ricevere dati. Mentre RECEIVE_AND_POST,MC_RECEIVE_AND_POST, RECEIVE_AND_WAITo MC_RECEIVE_AND_WAIT è in sospeso, può comunque usare SEND_ERRORo MC_SEND_ERRORe REQUEST_TO_SENDo MC_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 il segnale dell'evento. Dopo aver segnalato l'evento, esaminare il codice restituito primario appC e il codice restituito secondario nel blocco di controllo verbo per eventuali condizioni di errore.