WlanHostedNetworkForceStop 関数 (wlanapi.h)
WlanHostedNetworkForceStop 関数は、要求をアプリケーションの呼び出しハンドルに関連付けることなく、ワイヤレスホスト型ネットワークをwlan_hosted_network_idleに移行します。
構文
DWORD WlanHostedNetworkForceStop(
[in] HANDLE hClientHandle,
[out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
PVOID pvReserved
);
パラメーター
[in] hClientHandle
WlanOpenHandle 関数の以前の呼び出しによって返されるクライアントのセッション ハンドル。
[out, optional] pFailReason
WlanHostedNetworkForceStop 関数の呼び出しが失敗した場合に、エラーの理由を受け取る値への省略可能なポインター。 エラーの原因として考えられる値は、Wlanapi.h ヘッダー ファイルで定義されているWLAN_HOSTED_NETWORK_REASON列挙型です。
pvReserved
将来利用するために予約されています。 このパラメーターは NULL である必要があります。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。
| リターン コード | 説明 |
|---|---|
|
ハンドルが無効です。 このエラーは、 hClientHandle パラメーターで指定されたハンドルがハンドル テーブルで見つからなかった場合に返されます。 |
|
パラメーターが正しくありません。 このエラーは、次のいずれかの条件が発生した場合に返されます。
|
|
リソースが、要求された操作を実行するための正しい状態ではありません。 |
|
サービスは開始されていません。 このエラーは、WLAN AutoConfig サービスが実行されていない場合に返されます。 |
|
さまざまな RPC とその他のエラー コード。 FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。 |
注釈
WlanHostedNetworkForceStop 関数は、ワイヤレス LAN サービスがインストールされた Windows 7 および Windows Server 2008 R2 のワイヤレス ホステッド ネットワークをサポートするために追加されたネイティブ ワイヤレス API の拡張機能です。
クライアント アプリケーションは WlanHostedNetworkForceStop 関数を呼び出して、ホストされたネットワークを強制的に停止し、要求をアプリケーションの呼び出しハンドルに関連付けることなく、ワイヤレスホステッド ネットワークを wlan_hosted_network_idle に移行します。 クライアントは通常 、WlanHostedNetworkForceStop 関数を呼び出して、 WlanHostedNetworkForceStart 関数への以前の正常な呼び出しと一致させます。
ホストされたネットワークの状態がwlan_hosted_network_activeされていない場合、WlanHostedNetworkForceStop 関数が失敗する可能性があります。
呼び出し元のアプリケーションが呼び出し元のハンドルを閉じる (hClientHandle パラメーターを指定して WlanCloseHandle を呼び出す) 場合、またはプロセスが終了した場合、この関数によって発生した Hosted Network 状態の変更は自動的に元に戻されません。
アプリケーションは 、WlanHostedNetworkForceStop 関数を呼び出して、無線ホスト型ネットワークの実行に関連する電力要件の増加を長期間受け入れた管理者特権のシステム ユーザーによる WlanHostedNetworkForceStart の前回の呼び出しの後、ホストされたネットワークを停止する場合があります。
どのユーザーも WlanHostedNetworkForceStop 関数を呼び出して、ホストされたネットワークを強制的に停止できます。 ただし、ワイヤレスホステッド ネットワークを有効にする機能は、ドメイン内のグループ ポリシーによって制限される場合があります。
Windows 7 以降では、ホスト型ネットワーク対応ワイヤレス アダプターがコンピューターに存在する場合、オペレーティング システムによって仮想デバイスがインストールされます。 この仮想デバイスは、通常、コンピューターに 1 つのワイヤレス ネットワーク アダプターがある場合、"ネットワーク Connections フォルダー" に "ワイヤレス ネットワーク接続 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 |