WSAUnadvertiseProvider 関数 (ws2spi.h)
WSAUnadvertiseProvider 関数を使用すると、特定の名前空間バージョン 2 プロバイダーがクライアントで使用できなくなります。
構文
INT WSAAPI WSAUnadvertiseProvider(
[in] const GUID *puuidProviderId
);
パラメーター
[in] puuidProviderId
名前空間プロバイダーのプロバイダー ID へのポインター。
戻り値
エラーが発生しない場合、 WSAUnadvertiseProvider は 0 を返します。 それ以外の場合は 、SOCKET_ERRORを返し、 WSAGetLastError を呼び出すことによって特定のエラー コードを使用できます。
| エラー コード | 意味 |
|---|---|
| パラメーターが無効でした。 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 |
| Library | Ws2_32.lib |
| [DLL] | Ws2_32.dll |