LPNSPV2LOOKUPSERVICEEND コールバック関数 (ws2spi.h)

[アーティクル]
08/28/2023

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

構文

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

INT Lpnspv2lookupserviceend(
  [in] HANDLE hLookup
)
{...}

パラメーター

[in] hLookup

の呼び出しによって以前に取得されたハンドル
NSPv2LookupServiceBegin。

戻り値

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

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

注釈

NSPv2LookupServiceEnd 関数は、Windows Vista 以降で使用できる名前空間サービスプロバイダーバージョン 2 (NSPv2) アーキテクチャの一部として使用されます。

Windows Vista および Windows Server 2008 では、 NSPv2LookupServiceEnd 関数は、NS_EMAIL名前空間プロバイダーでの操作にのみ使用できます。

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

Windows ソケット 2 では、競合するエラーコードが WSAECANCELLED および WSA_E_CANCELLEDに対して定義されています。エラーコード WSAECANCELLED は今後のバージョンで削除され、WSA_E_CANCELLEDのみが残ります。名前空間プロバイダーは、WSA_E_CANCELLEDエラーコードを使用して、可能な限り幅広いアプリケーションとの互換性を維持する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	ws2spi.h