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