共用方式為

WSAProviderCompleteAsyncCall 函式 (ws2spi.h)

  • 發行項

WSAProviderCompleteAsyncCall 函式會在命名空間第 2 版提供者的異步呼叫完成時通知用戶端。

語法

INT WSAAPI WSAProviderCompleteAsyncCall(
  HANDLE hAsyncCall,
  INT    iRetCode
);

參數

hAsyncCall

傳遞至正在完成之異步呼叫的句柄。 此句柄會由客戶端在異步函式呼叫中傳遞至命名空間第 2 版提供者。

iRetCode

命名空間第 2 版提供者異步呼叫的傳回碼。

傳回值

如果沒有發生錯誤， WSAProviderCompleteAsyncCall 會傳回零。

如果函式失敗，傳回值會SOCKET_ERROR。 若要取得擴充錯誤資訊，請呼叫 WSAGetLastError，這會傳回下列其中一個擴充錯誤值。

錯誤碼 意義
WSA_NOT_ENOUGH_MEMORY
 記憶體不足，無法執行作業。
WSAEFAULT
 發生內部錯誤。
WSAEINVAL
 參數無效。 如果 hAsyncCall 參數為 **NULL**，就會傳回此錯誤。
WSANOTINITIALISED
 Ws2_32.dll 尚未初始化 。 應用程式必須先呼叫 WSAStartup ，才能呼叫任何 Windows Sockets 函式。

備註

WSAProviderCompleteAsyncCall 函式是作為 Windows Vista 和更新版本上可用的命名空間服務提供者版本 2 (NSPv2) 架構的一部分。

在 Windows Vista 和 Windows Server 2008 上， WSAUnadvertiseProvider 函式只能用於NS_EMAIL命名空間提供者上的作業。 Windows Vista 和 Windows Server 2008 不支援對 NSPv2 提供者的異步呼叫。 因此 ，WSAProviderCompleteAsyncCall 目前不適用。 當支援命名空間提供者的異步呼叫時，此函式計劃用於較新版本的 Windows。

一般而言，NSPv2 提供者會在呼叫應用程式以外的進程中實作。 NSPv2 提供者不會因為客戶端活動而啟動。 每個裝載應用程式的提供者都會決定何時呼叫 WSAAdvertiseProvider 和 WSAUnadvertiseProvider 函 式，讓特定提供者可供使用或無法使用。 用戶端活動只會在命名空間提供者公告) 時，嘗試連絡提供者時 (。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 ws2spi.h
程式庫 Ws2_32.lib
Dll Ws2_32.dll

另請參閱

NSPV2_ROUTINE

WSAAdvertiseProvider

WSAGetLastError

WSAUnadvertiseProvider