Estensioni per l'ambiente Windows

In questa sezione vengono descritte le estensioni API a Microsoft® Windows® Common Programming Interface for Communications (CPI-C) che consentono il completamento verbo non sbloccante o asincrono. I verbi asincroni restituiscono immediatamente il controllo al programma, senza attendere l'esecuzione completa e devono notificare l'applicazione in un secondo momento al completamento del verbo. Un'applicazione viene inoltre notificata in risposta al completamento di una chiamata Wait_For_Conversation . Al contrario, i verbi sincroni bloccano, ovvero la chiamata alla funzione non restituisce fino al completamento della chiamata.

In Microsoft® Windows Server sono disponibili due metodi per gestire il completamento del verbo asincrono:

  • Registrazione dei messaggi tramite handle delle finestre.

  • In attesa degli eventi Win32®.

    Il primo metodo usa messaggi pubblicati in un handle di finestra per notificare un'applicazione di completamento verbo. Esiste una finestra di questo tipo per ogni applicazione CPI-C. Ogni conversazione CPI-C può avere un verbo asincrono in qualsiasi momento. Al termine di un verbo, la registrazione alla finestra accetta come parametri l'identificatore della conversazione CPI-C del verbo completato e il codice restituito del verbo.

Nota

Le estensioni che usano handle delle finestre e la registrazione dei messaggi descritti in questa sezione sono state progettate per tutte le implementazioni e le versioni di Microsoft Windows. Sono ora supportati solo per Windows.

Un secondo metodo che usa eventi Win32 per la notifica è supportato in Microsoft® Host Integration Server. Le estensioni che usano eventi Win32 descritti in questa sezione (WinCPICSetEvent eWinCPICExtractEvent) operano solo in Windows Server e offrono le prestazioni ottimali dell'applicazione nell'ambiente operativo a 32 bit. Se un evento è stato registrato con la conversazione, un'applicazione può chiamare la funzione WaitForSingleObject o WaitForMultipleObjects per ricevere una notifica del completamento del verbo.

Windows CPI-C consente processi basati su Windows multithreading. Multithreading è l'esecuzione di diversi processi in sequenza rapida all'interno di un singolo programma. Un processo contiene uno o più thread di esecuzione.

Le descrizioni delle estensioni in questa sezione forniscono una definizione della funzione, della sintassi, dei valori restituiti e delle osservazioni per l'uso di queste estensioni di Windows nei programmi CPI-C.

Contenuto della sezione