LPNSPV2LOOKUPSERVICEEND コールバック関数 (ws2spi.h)
NSPv2LookupServiceEnd 関数は、NSPv2LookupServiceBegin および NSPv2LookupServiceNextEx を以前に呼び出した後にハンドルを解放するために呼び出されます。
構文
LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;
INT Lpnspv2lookupserviceend(
[in] HANDLE hLookup
)
{...}
パラメーター
[in] hLookup
の呼び出しによって以前に取得されたハンドル
NSPv2LookupServiceBegin。
戻り値
ルーチンが成功した場合、関数は NO_ERROR (ゼロ) を返す必要があります。 ルーチン が 失敗し、 WSASetLastError を使用して適切なエラー コードを設定する必要がある場合は、SOCKET_ERROR (つまり 1) を返す必要があります。
エラー コード | 意味 |
---|---|
ハンドルが無効です。 | |
この操作を実行するのに十分なメモリがありません。 |
注釈
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 |