WskRegister 関数 (wsk.h)

WskRegister 関数は、アプリケーションの WSK クライアントネットワークプログラミングインターフェイス (NPI) を指定して、WSK アプリケーションを登録します。

構文

NTSTATUS WskRegister(
  [in]  PWSK_CLIENT_NPI   WskClientNpi,
  [out] PWSK_REGISTRATION WskRegistration
);

[in] WskClientNpi

WSK アプリケーションによって実装されるクライアント NPI へのポインター。

[out] WskRegistration

WSK アプリケーションの登録インスタンスを識別するメモリの場所へのポインター。このメモリの場所は WskRegister 呼び出しによって初期化され、他の WSK 登録関数によって使用されます。 WSK アプリケーションでは、このメモリの場所の内容を直接変更しないでください。

WskRegister は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	登録が成功しました。
その他の状態コード	登録に失敗しました。

WSK クライアントオブジェクトは、この関数を複数回呼び出すことができますが、複数の登録インスタンスを作成するには、呼び出しごとに異なる WskRegistration パラメーターを使用する必要があります。

成功コードを返す WskRegister の呼び出しごとに、 WskRegister に渡されたのと同じ WskRegistration パラメーターを使用する対応する WskDeregister 呼び出しが 1 つだけ存在する必要があります。

WskRegistration が指すメモリブロックは、他の WSK 登録関数への未処理の呼び出しがある限り、割り当てられたままにしておく必要があります (解放したり、スコープ外に出したりすることはできません)。

WSK アプリケーションを登録および登録解除するには、 WskRegister 関数と WskDeregister 関数を使用することをお勧めします。ネットワークモジュールレジストラーは互換性のために引き続き使用できます。

WSK アプリケーションを WSK サブシステムにアタッチする方法の詳細については、「 Winsock カーネルアプリケーションの登録」を参照してください。

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	wsk.h (Wsk.h を含む)
Library	Netio.lib
IRQL	PASSIVE_LEVEL