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