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