WSAUnadvertiseProvider 函式 (ws2spi.h)

  • 發行項

WSAUnadvertiseProvider 函式讓特定的命名空間第 2 版提供者不再可供用戶端使用。

語法

INT WSAAPI WSAUnadvertiseProvider(
  [in] const GUID *puuidProviderId
);

參數

[in] puuidProviderId

命名空間提供者之提供者標識碼的指標。

傳回值

如果沒有發生錯誤， WSAUnadvertiseProvider 會 傳回零。 否則，它會傳回 SOCKET_ERROR，而且呼叫 WSAGetLastError 即可使用特定的錯誤碼。

錯誤碼 意義
WSAEINVAL
 參數無效。 如果 puuidProviderId 參數為 **NULL**，就會傳回此錯誤。

備註

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

在 Windows Vista 和 Windows Server 2008 上， WSAUnadvertiseProvider 函式只能用於NS_EMAIL命名空間提供者上的作業。

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

規格需求

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

另請參閱

NSPV2_ROUTINE

WSAAdvertiseProvider

WSAEnumNameSpaceProviders

WSAEnumNameSpaceProvidersEx

WSASetService