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

[アーティクル]
03/09/2024

NSPv2Startup 関数は、新しいクライアントプロセスがプロバイダーの使用を開始することを名前空間サービスプロバイダーバージョン 2 (NSPv2) プロバイダーに通知します。

構文

LPNSPV2STARTUP Lpnspv2startup;

INT Lpnspv2startup(
  [in] LPGUID lpProviderId,
  [in] LPVOID *ppvClientSessionArg
)
{...}

パラメーター

[in] lpProviderId

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

[in] ppvClientSessionArg

クライアントセッションへのポインター。

戻り値

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

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

注釈

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

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

NSPv2Startup 関数は、新しいクライアントプロセスが名前空間プロバイダーの使用を開始するたびに呼び出されます。プロバイダーは、 ppvClientSessionArg パラメーターが指すクライアントセッション引数を使用して、このセッションに関する情報を格納できます。 ppvClientSessionArg パラメーターの値は、同じセッション内の後続の NSPv2 関数呼び出しに渡されます。名前空間プロバイダーがこの情報を必要としない場合、クライアントセッション引数は NULL になる可能性があります。

NSPv2Startup 関数は、新しいクライアントセッションが初期化されるときに呼び出されます。 NSPv2Startup 関数と NSPv2Cleanup 関数は、ペアとして呼び出す必要があります。

NSPv2Cleanup 関数を呼び出す前に、NSPv2Startup 関数を正常に呼び出す必要があります。複数の NSPv2Startup 呼び出しを行うことができます。ただし、 NSPv2Startup 呼び出しごとに、対応する NSPv2Cleanup 呼び出しも発行する必要があります。実際のクリーンアップは、サービスプロバイダーの最終的な NSPv2Cleanup のみです。上記の呼び出しは、名前空間サービスプロバイダーの内部参照カウントをデクリメントします。

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

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

要件

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