Funzione WSAProviderCompleteAsyncCall (ws2spi.h)
La funzione WSAProviderCompleteAsyncCall notifica a un client quando viene completata una chiamata asincrona a un provider dello spazio dei nomi versione 2.
Sintassi
INT WSAAPI WSAProviderCompleteAsyncCall(
HANDLE hAsyncCall,
INT iRetCode
);
Parametri
hAsyncCall
Handle passato alla chiamata asincrona completata. Questo handle viene passato dal client al provider dello spazio dei nomi version-2 nella chiamata di funzione asincrona.
iRetCode
Codice restituito per la chiamata asincrona al provider dello spazio dei nomi versione 2.
Valore restituito
Se non si verifica alcun errore, WSAProviderCompleteAsyncCall restituisce zero.
Se la funzione ha esito negativo, il valore restituito viene SOCKET_ERROR. Per ottenere informazioni sugli errori estese, chiamare WSAGetLastError, che restituisce uno dei valori di errore estesi seguenti.
| Codice di errore | Significato |
|---|---|
| Memoria insufficiente per eseguire l'operazione. | |
| An internal error occurred. | |
| Parametro non valido. Questo errore viene restituito se il parametro hAsyncCall è **NULL**. | |
| Il Ws2_32.dll non è stato inizializzato. L'applicazione deve prima chiamare WSAStartup prima di chiamare qualsiasi funzione Di Windows Sockets. |
Commenti
La funzione WSAProviderCompleteAsyncCall viene usata come parte dell'architettura del provider di servizi dello spazio dei nomi versione 2 (NSPv2) disponibile in Windows Vista e versioni successive.
In Windows Vista e Windows Server 2008 la funzione WSAUnadvertiseProvider può essere usata solo per le operazioni sui provider di spazi dei nomi NS_EMAIL. Le chiamate asincrone ai provider NSPv2 non sono supportate in Windows Vista e Windows Server 2008. Pertanto WSAProviderCompleteAsyncCall non è attualmente applicabile. Questa funzione è pianificata per l'uso nelle versioni successive di Windows quando sono supportate le chiamate asincrone ai provider dello spazio dei nomi.
In generale, i provider NSPv2 vengono implementati in processi diversi dalle applicazioni chiamanti. I provider NSPv2 non vengono attivati in seguito all'attività del client. Ogni applicazione di hosting del provider decide quando rendere disponibile o non disponibile un provider specifico chiamando le funzioni WSAAAdvertiseProvider e WSAUnadvertiseProvider . L'attività client comporta solo tentativi di contattare il provider, quando disponibile (quando il provider dello spazio dei nomi viene annunciato).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ws2spi.h |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |