Share via

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

  • [アーティクル]

NSPv2ClientSessionRundown 関数は、クライアント セッションが終了していることを名前空間サービス プロバイダー バージョン 2 (NSPv2) プロバイダーに通知します。

構文

LPNSPV2CLIENTSESSIONRUNDOWN Lpnspv2clientsessionrundown;

void Lpnspv2clientsessionrundown(
  [in] LPGUID lpProviderId,
  [in] LPVOID pvClientSessionArg
)
{...}

パラメーター

[in] lpProviderId

通知する特定の名前空間プロバイダーの GUID へのポインター。

[in] pvClientSessionArg

終了しているクライアント セッションへのポインター。

戻り値

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

エラー コード 意味
WSA_NOT_ENOUGH_MEMORY
 この操作を実行するのに十分なメモリがありません。
WSAEACCES
 呼び出し元ルーチンには、サービスをインストールするための十分な特権がありません。
WSAEINVAL
 このプロバイダーに対して、1 つ以上のパラメーターが無効であるか、不足しています。
WSAEOPNOTSUPP
 この操作はサポートされていません。 名前空間プロバイダーがこの関数を実装していない場合、このエラーが返されます。 このエラーは、指定された dwControlCode が認識されないコマンドである場合にも返すことができます。
WSASERVICE_NOT_FOUND
 サービスが不明です。 指定した名前空間にサービスが見つかりません。

解説

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

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

NSPv2Startup 関数は、新しいクライアント プロセスが名前空間プロバイダーの使用を開始するたびに呼び出されます。 プロバイダーは、 ppvClientSessionArg パラメーターが指すクライアント セッション引数を使用して、このセッションに関する情報を格納できます。 NSPv2Startup 関数の呼び出しでクライアント セッション引数に値が指定された場合、この同じクライアント セッション引数が pvClientSessionArg パラメーターで NSPv2ClientSessionRundown 関数に渡されます。

NSPv2Startup、NSPv2ClientSessionRundown、および NSPv2Cleanup 関数は、NSPv2 プロバイダーの要件に応じてオプションです。

NSPv2ClientSessionRundown 関数が実装されていない場合、その関数の呼び出しは、WSAEOPNOTSUPP を返すスタブ関数によってインターセプトされる必要があります。 NSPV2_ROUTINE構造体の実装されていない NSPv2ClientSessionRundown 関数への NSPv2 関数ポインターは、スタブ関数を指している必要があります。

要件

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

関連項目

NSPV2_ROUTINE

NSPv2Cleanup

NSPv2LookupServiceBegin

NSPv2LookupServiceEnd

NSPv2LookupServiceNextEx

NSPv2SetServiceEx

NSPv2Startup

WSAQUERYSET2

WSASetLastError