Win32 API 日本語リファレンス
ホーム › Networking.WinSock › LPNSPV2LOOKUPSERVICEEND

LPNSPV2LOOKUPSERVICEEND

コールバック

シグネチャ

INT LPNSPV2LOOKUPSERVICEEND(
    HANDLE hLookup
);

パラメーター

フィールド型説明
hLookupHANDLE以前に NSPv2LookupServiceBegin を呼び出して取得したハンドル。

公式ドキュメント

NSPv2LookupServiceEnd 関数は、 NSPv2LookupServiceBegin および NSPv2LookupServiceNextEx の呼び出し後に、ハンドルを解放するために呼び出されます。

戻り値

この関数は、ルーチンが成功した場合は NO_ERROR (ゼロ) を返します。ルーチンが失敗した場合は SOCKET_ERROR (すなわち 1) を返し、WSASetLastError を使用して適切なエラーコードを設定する必要があります。

エラーコード 意味
WSA_INVALID_HANDLE
ハンドルが有効ではありません。
WSA_NOT_ENOUGH_MEMORY
この操作を実行するための十分なメモリがありません。

解説(Remarks)

NSPv2LookupServiceEnd 関数は、Windows Vista 以降で利用可能なネームスペースサービスプロバイダーバージョン 2 (NSPv2) アーキテクチャの一部として使用されます。

Windows Vista および Windows Server 2008 では、NSPv2LookupServiceEnd 関数は NS_EMAIL ネームスペースプロバイダーに対する操作にのみ使用できます。

NSPv2LookupServiceNextEx の処理中に、別のスレッドで NSPv2LookupServiceBegin 関数の呼び出しを受け取ることがあります。これは、クライアントが要求を取り消したことを示しており、プロバイダーはハンドルを閉じ、最後のエラーを WSA_E_CANCELLED に設定して NSPv2LookupServiceNextEx 関数の呼び出しからも戻る必要があります。

Windows Sockets 2 では、WSAECANCELLED と WSA_E_CANCELLED に競合するエラーコードが定義されています。エラーコード WSAECANCELLED は将来のバージョンで削除され、WSA_E_CANCELLED のみが残ります。ネームスペースプロバイダーは、可能な限り広範囲のアプリケーションとの互換性を維持するために、WSA_E_CANCELLED エラーコードを使用してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)