Estensioni APPC per l'ambiente Windows
Questa sezione descrive le estensioni API a Windows Advanced Program-to-Program Communications (APPC) che consentono la comunicazione asincrona. La comunicazione asincrona si verifica quando una funzione viene restituita prima del completamento della richiesta. L'applicazione viene notificata in un secondo momento al completamento della richiesta.
In Microsoft® Windows® sono disponibili tre metodi per la comunicazione asincrona usando l'API APPC:
Registrazione dei messaggi tramite handle delle finestre.
In attesa degli eventi Win32®.
Uso delle porte di completamento di I/O Win32.
Il primo metodo usa messaggi pubblicati in un handle di finestra per notificare un'applicazione di completamento verbo. Questo metodo usa handle di finestre e messaggi è stato supportato in Microsoft Windows 3.x. Esiste una finestra di questo tipo per ogni applicazione APPC, indipendentemente dal numero di conversazioni. Ogni conversazione APPC può avere un verbo asincrono in sospeso in qualsiasi momento. Al termine di un verbo, la registrazione alla finestra accetta come parametri l'handle di attività asincrona restituito dalla chiamata originale e un puntatore al blocco di controllo verbo completato, contenente i codici restituiti del verbo.
Le estensioni che usano handle delle finestre e la registrazione dei messaggi descritti in questa sezione (WinAsyncAPPC) sono state progettate per tutte le implementazioni e le versioni di Microsoft Windows dalla versione 3.0 alle versioni più recenti di Windows. Hanno fornito la compatibilità per la programmazione di Windows e le prestazioni ottimali dell'applicazione nell'ambiente operativo Windows a 16 bit.
È supportato un secondo metodo che usa eventi Win32 per la notifica. Le estensioni che usano eventi Win32 descritti in questa sezione (WinAsyncAPPCEx) operano solo in Windows e offrono prestazioni ottimali dell'applicazione nell'ambiente operativo Windows 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.
Un terzo metodo che usa porte di completamento di I/O Win32 per la notifica è supportato in Windows. Le estensioni che usano le porte di completamento di I/O descritte in questa sezione (WinAsyncAPPCIOCP) operano solo in Windows e offrono prestazioni ottimali dell'applicazione nell'ambiente operativo Windows a 32 bit. Se è stata creata una porta di completamento di I/O tramite CreateIoCompletionPort, un'applicazione può chiamare la funzione GetQueuedCompletionStatus per ricevere una notifica del completamento del verbo.
Windows APPC consente processi basati su Windows multithreading. Un processo contiene uno o più thread di esecuzione. Tutti i riferimenti ai thread in questo documento fanno riferimento ai thread effettivi negli ambienti Windows multithreading.
Questa sezione fornisce, per ogni estensione, una definizione della funzione, della sintassi, restituisce e osservazioni per l'uso della funzione.