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 コードを返します。
| リターン コード | 形容 |
|---|---|
|
登録に成功しました。 |
|
登録に失敗しました。 |
備考
WSK クライアント オブジェクトは、この関数を複数回呼び出すことができますが、複数の登録インスタンスを作成するには、呼び出しごとに異なる WskRegistration パラメーターを使用する必要があります。
成功コードを返す WskRegister を する呼び出しごとに、WskRegistration に渡されたのと同じ WskRegistration パラメーターを使用する、WskDeregister 呼び出し 対応する呼び出し1 つだけ必要です。
wskRegistration が指すメモリ ブロックは、WSK 登録関数 他のへの未処理の呼び出しがある限り、割り当てられたままにしておく必要があります (解放したり、スコープ外に出したりすることはできません)。
wskRegister と wskDeregister 関数 使用することは、WSK アプリケーションを登録および登録解除するための推奨される方法です。 ネットワーク モジュール レジストラー は互換性のために引き続き使用できます。
WSK アプリケーションを WSK サブシステムにアタッチする方法の詳細については、「Winsock カーネル アプリケーションの登録」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wsk.h (Wsk.h を含む) |
| ライブラリ | Netio.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
WskDeregister の