WlanRegisterVirtualStationNotification 関数 (wlanapi.h)
WlanRegisterVirtualStationNotification 関数は、仮想ステーションでの通知の登録と登録解除に使用されます。
構文
DWORD WlanRegisterVirtualStationNotification(
[in] HANDLE hClientHandle,
[in] BOOL bRegister,
PVOID pReserved
);
パラメーター
[in] hClientHandle
WlanOpenHandle 関数の以前の呼び出しによって取得されたクライアントのセッション ハンドル。
[in] bRegister
仮想ステーションで通知を受信するかどうかを示す 値です。
pReserved
将来利用するために予約されています。 このパラメーターは NULL である必要があります。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。
| リターン コード | 説明 |
|---|---|
|
パラメーターが正しくありません。 このエラーは、次のいずれかの条件が発生した場合に返されます。
|
|
ハンドルが無効です。 このエラーは、 hClientHandle パラメーターで指定されたハンドルがハンドル テーブルで見つからなかった場合に返されます。 |
|
リソースが、要求された操作を実行するための正しい状態ではありません。 このエラーは、ワイヤレス ホスト型ネットワークがドメインのグループ ポリシーによって無効になっている場合に返されます。 |
|
サービスは開始されていません。 このエラーは、WLAN AutoConfig サービスが実行されていない場合に返されます。 |
|
さまざまな RPC とその他のエラー コード。 FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。 |
解説
WlanRegisterVirtualStationNotification 関数は、ワイヤレス LAN サービスがインストールされた Windows 7 および Windows Server 2008 R2 上のワイヤレス ホステッド ネットワークをサポートするために追加されたネイティブ ワイヤレス API の拡張機能です。
クライアント アプリケーションは 、WlanRegisterVirtualStationNotification 関数を呼び出して、仮想ステーションでの通知の登録と登録解除を行います。
呼び出し元のアプリケーションが呼び出しハンドルを閉じる (hClientHandle パラメーターを指定して WlanCloseHandle を呼び出す) 場合、またはプロセスが終了した場合、この関数によって発生した仮想ステーションから通知を受信するための登録は自動的に元に戻されます。
既定では、アプリケーション クライアントは仮想ステーションで通知を受信しません。 これらの通知を受信するには、クライアントは bRegister パラメーターを TRUE に設定して WlanRegisterVirtualStationNotification 関数を呼び出す必要があります。また、登録する通知ソースに dwNotifSource パラメーターを設定して WlanRegisterNotification 関数を呼び出す必要があります。 仮想ステーションから通知を受信するための登録は、アプリケーションがクライアント ハンドルを閉じるまで有効になります (hClientHandle パラメーターを使用して WlanCloseHandle を呼び出すことによって)、プロセスが終了するか、bRegister パラメーターを FALSE に設定して WlanRegisterVirtualStationNotification 関数が呼び出されます。
Windows 7 以降では、ホスト型ネットワーク対応ワイヤレス アダプターがコンピューターに存在する場合、オペレーティング システムによって仮想デバイスがインストールされます。 この仮想デバイスは、通常、コンピューターに 1 つのワイヤレス ネットワーク アダプターがある場合、"ネットワーク接続フォルダー" に "ワイヤレス ネットワーク接続 2" として表示され、デバイス名は "Microsoft Virtual WiFi ミニポート アダプター" になります。 この仮想デバイスは、ソフトウェア アクセス ポイント (SoftAP) 接続の実行専用に使用され、 WlanEnumInterfaces 関数によって返されるリストには存在しません。 この仮想デバイスの有効期間は、物理ワイヤレス アダプターに関連付けられます。 物理ワイヤレス アダプターが無効になっている場合、この仮想デバイスも削除されます。 この機能は、ワイヤレス LAN サービスがインストールされている Windows Server 2008 R2 でも使用できます。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wlanapi.h (Wlanapi.h を含む) |
| Library | Wlanapi.lib |
| [DLL] | Wlanapi.dll |