LPNSPV2LOOKUPSERVICEEND
コールバックシグネチャ
INT LPNSPV2LOOKUPSERVICEEND(
HANDLE hLookup
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| hLookup | HANDLE | 以前に NSPv2LookupServiceBegin を呼び出して取得したハンドル。 |
公式ドキュメント
NSPv2LookupServiceEnd 関数は、 NSPv2LookupServiceBegin および NSPv2LookupServiceNextEx の呼び出し後に、ハンドルを解放するために呼び出されます。
戻り値
この関数は、ルーチンが成功した場合は NO_ERROR (ゼロ) を返します。ルーチンが失敗した場合は SOCKET_ERROR (すなわち 1) を返し、WSASetLastError を使用して適切なエラーコードを設定する必要があります。
| エラーコード | 意味 |
|---|---|
| ハンドルが有効ではありません。 | |
| この操作を実行するための十分なメモリがありません。 |
解説(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 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)