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

LPNSPLOOKUPSERVICEEND

コールバック

シグネチャ

INT LPNSPLOOKUPSERVICEEND(
    HANDLE hLookup
);

パラメーター

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

公式ドキュメント

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

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

戻り値

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

エラーコード 意味
WSA_INVALID_HANDLE
ハンドルが有効ではありません。
WSA_NOT_ENOUGH_MEMORY
この操作を実行するのに十分なメモリがありません。
WSAEOPNOTSUPP
この操作はサポートされていません。名前空間プロバイダーがこの関数を実装していない場合に、このエラーが返されます。

解説(Remarks)

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)