WSAProviderCompleteAsyncCall-Funktion (ws2spi.h)
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 |
|---|---|
| Es war nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. | |
| Interner Fehler. | |
| Ein Parameter war ungültig. Dieser Fehler wird zurückgegeben, wenn der hAsyncCall-Parameter **NULL** lautet. | |
| 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 |