WSAProviderCompleteAsyncCall-Funktion (ws2spi.h)

  • Artikel

Die WSAProviderCompleteAsyncCall-Funktion benachrichtigt einen Client, wenn ein asynchroner Aufruf eines Namespaceanbieters der Version 2 abgeschlossen ist.

Syntax

INT WSAAPI WSAProviderCompleteAsyncCall(
  HANDLE hAsyncCall,
  INT    iRetCode
);

Parameter

hAsyncCall

Das Handle, das an den asynchronen Aufruf übergeben wird, der abgeschlossen wird. Dieses Handle wird vom Client im asynchronen Funktionsaufruf an den Anbieter der Namespaceversion 2 übergeben.

iRetCode

Der Rückgabecode für den asynchronen Aufruf des Anbieters der Namespaceversion 2.

Rückgabewert

Wenn kein Fehler auftritt, gibt WSAProviderCompleteAsyncCall null zurück.

Wenn die Funktion fehlschlägt, wird der Rückgabewert SOCKET_ERROR. Rufen Sie zum Abrufen erweiterter Fehlerinformationen WSAGetLastError auf. Dadurch wird einer der folgenden erweiterten Fehlerwerte zurückgegeben.

Fehlercode Bedeutung
WSA_NOT_ENOUGH_MEMORY
 Es war nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
WSAEFAULT
 Interner Fehler.
WSAEINVAL
 Ein Parameter war ungültig. Dieser Fehler wird zurückgegeben, wenn der hAsyncCall-Parameter **NULL** lautet.
WSANOTINITIALISIERT
 Die Ws2_32.dll wurde nicht initialisiert. Die Anwendung muss zuerst WSAStartup aufrufen, bevor Windows Sockets-Funktionen aufgerufen werden.

Hinweise

Die WSAProviderCompleteAsyncCall-Funktion wird als Teil der Architektur des Namespacedienstanbieters Version-2 (NSPv2) verwendet, die unter Windows Vista und höher verfügbar ist.

Unter Windows Vista und Windows Server 2008 kann die WSAUnadvertiseProvider-Funktion nur für Vorgänge auf NS_EMAIL Namespaceanbietern verwendet werden. Asynchrone Aufrufe von NSPv2-Anbietern werden unter Windows Vista und Windows Server 2008 nicht unterstützt. Daher ist WSAProviderCompleteAsyncCall derzeit nicht anwendbar. Diese Funktion ist für die Verwendung in späteren Versionen von Windows geplant, wenn asynchrone Aufrufe von Namespaceanbietern unterstützt werden.

Im Allgemeinen werden NSPv2-Anbieter in anderen Prozessen als den aufrufenden Anwendungen implementiert. NSPv2-Anbieter werden aufgrund der Clientaktivität nicht aktiviert. Jeder Anbieter, der eine Anwendung hostet, entscheidet, wann ein bestimmter Anbieter verfügbar oder nicht verfügbar ist, indem er die Funktionen WSAAdvertiseProvider und WSAUnadvertiseProvider aufruft . Die Clientaktivität führt nur zu Kontaktversuchen mit dem Anbieter, sofern verfügbar (wenn der Namespaceanbieter angekündigt wird).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ws2spi.h
Bibliothek Ws2_32.lib
DLL Ws2_32.dll

Weitere Informationen

NSPV2_ROUTINE

WSAAdvertiseProvider

WSAGetLastError

WSAUnadvertiseProvider