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