WLAN_HOSTED_NETWORK_REASON 列挙 (wlanapi.h)

[アーティクル]
03/08/2023

WLAN_HOSTED_NETWORK_REASON列挙型は、ワイヤレス Hosted Network 関数呼び出しの結果に使用できる値を指定します。

構文

typedef enum _WLAN_HOSTED_NETWORK_REASON {
  wlan_hosted_network_reason_success = 0,
  wlan_hosted_network_reason_unspecified,
  wlan_hosted_network_reason_bad_parameters,
  wlan_hosted_network_reason_service_shutting_down,
  wlan_hosted_network_reason_insufficient_resources,
  wlan_hosted_network_reason_elevation_required,
  wlan_hosted_network_reason_read_only,
  wlan_hosted_network_reason_persistence_failed,
  wlan_hosted_network_reason_crypt_error,
  wlan_hosted_network_reason_impersonation,
  wlan_hosted_network_reason_stop_before_start,
  wlan_hosted_network_reason_interface_available,
  wlan_hosted_network_reason_interface_unavailable,
  wlan_hosted_network_reason_miniport_stopped,
  wlan_hosted_network_reason_miniport_started,
  wlan_hosted_network_reason_incompatible_connection_started,
  wlan_hosted_network_reason_incompatible_connection_stopped,
  wlan_hosted_network_reason_user_action,
  wlan_hosted_network_reason_client_abort,
  wlan_hosted_network_reason_ap_start_failed,
  wlan_hosted_network_reason_peer_arrived,
  wlan_hosted_network_reason_peer_departed,
  wlan_hosted_network_reason_peer_timeout,
  wlan_hosted_network_reason_gp_denied,
  wlan_hosted_network_reason_service_unavailable,
  wlan_hosted_network_reason_device_change,
  wlan_hosted_network_reason_properties_change,
  wlan_hosted_network_reason_virtual_station_blocking_use,
  wlan_hosted_network_reason_service_available_on_virtual_station
} WLAN_HOSTED_NETWORK_REASON, *PWLAN_HOSTED_NETWORK_REASON;

定数


`wlan_hosted_network_reason_success` 値: 0 操作に成功しました。
`wlan_hosted_network_reason_unspecified` 不明なエラー。
`wlan_hosted_network_reason_bad_parameters` パラメーターが正しくありません。たとえば、アプリケーションが正しいハンドル ( WlanOpenHandle 関数によって返されるハンドル) からクライアントコンテキストを参照できなかった場合、この理由コードが返されます。
`wlan_hosted_network_reason_service_shutting_down` サービスがシャットダウンしています。
`wlan_hosted_network_reason_insufficient_resources` サービスがリソース不足です。
`wlan_hosted_network_reason_elevation_required` この操作には昇格が必要です。
`wlan_hosted_network_reason_read_only` 読み取り専用データを書き込もうとしました。
`wlan_hosted_network_reason_persistence_failed` データの永続化に失敗しました。
`wlan_hosted_network_reason_crypt_error` 暗号化エラーが発生しました。
`wlan_hosted_network_reason_impersonation` ユーザーの偽装に失敗しました。
`wlan_hosted_network_reason_stop_before_start` 関数呼び出しシーケンスが正しくありません。
`wlan_hosted_network_reason_interface_available` ワイヤレスインターフェイスが使用可能になりました。
`wlan_hosted_network_reason_interface_unavailable` ワイヤレスインターフェイスが使用できなくなります。この理由コードは、ワイヤレスホステッドネットワークのネットワーク状態が wlan_hosted_network_unavailableされるたびに、ワイヤレスホステッドネットワーク機能によって返されます。たとえば、ワイヤレスホステッドネットワークがドメインのグループポリシーによって無効になっている場合、ワイヤレスホステッドネットワークのネットワーク状態は wlan_hosted_network_unavailable。この場合、 WlanHostedNetworkStartUsing または WlanHostedNetworkForceStart 関数を呼び出すと、この理由コードが返されます。
`wlan_hosted_network_reason_miniport_stopped` ワイヤレスミニポートドライバーがホストされたネットワークを停止しました。
`wlan_hosted_network_reason_miniport_started` ワイヤレスミニポートドライバーの状態が変更されました。
`wlan_hosted_network_reason_incompatible_connection_started` 互換性のない接続が開始されました。互換性のない接続は、次のいずれかの場合を指します。プライマリステーションアダプターでアドホックワイヤレス接続が開始されます。ネットワーク監視は、OpCode パラメーターを wlan_intf_opcode_current_operation_mode に設定して WlanSetInterface 関数を呼び出し、pData パラメーターがDOT11_OPERATION_MODE_NETWORK_MONITORを含む ULONG を指すアプリケーション (ネットワークモニターなど) によってプライマリステーションアダプターで開始されます。ワイヤレス接続は、プライマリステーションアダプターの FIPS セーフモードで開始されます。 FIPS セーフモードは、ワイヤレス接続のプロファイルで指定されます。詳細については、 FIPSMode 要素に関するページを参照してください。 Windows は、プライマリステーションアダプターで互換性のない接続が開始されると、ソフトウェアベースのワイヤレスアクセスポイント (AP) アダプター上のワイヤレスホスト型ネットワークを停止します。ワイヤレスホステッドネットワーク状態のネットワーク状態は wlan_hosted_network_unavailableになります。
`wlan_hosted_network_reason_incompatible_connection_stopped` 互換性のない接続が停止しました。互換性のない接続は、以前にプライマリステーションアダプター (wlan_hosted_network_reason_incompatible_connection_started) で開始されましたが、互換性のない接続が停止しました。互換性のない接続が開始された結果、ワイヤレスホスト型ネットワークが以前に停止した場合、Windows はワイヤレスホスト型ネットワークを自動的に再起動しません。アプリケーションは、 WlanHostedNetworkStartUsing または WlanHostedNetworkForceStart 関数を呼び出すことによって、AP アダプター上のワイヤレスホスト型ネットワークを再起動できます。
`wlan_hosted_network_reason_user_action` 明示的なユーザーアクションによって発生した状態変更が発生しました。
`wlan_hosted_network_reason_client_abort` クライアントの中止によって発生した状態変更が発生しました。
`wlan_hosted_network_reason_ap_start_failed` ワイヤレスホステッドネットワークのドライバーを起動できませんでした。
`wlan_hosted_network_reason_peer_arrived` ワイヤレスホステッドネットワークに接続されているピア。
`wlan_hosted_network_reason_peer_departed` ワイヤレスホステッドネットワークから切断されたピア。
`wlan_hosted_network_reason_peer_timeout` ピアがタイムアウトしました。
`wlan_hosted_network_reason_gp_denied` 操作がグループポリシーによって拒否されました。
`wlan_hosted_network_reason_service_unavailable` ワイヤレス LAN サービスが実行されていません。
`wlan_hosted_network_reason_device_change` ワイヤレスホステッドネットワークで使用されるワイヤレスアダプターが変更されました。
`wlan_hosted_network_reason_properties_change` ワイヤレスホステッドネットワークのプロパティが変更されました。
`wlan_hosted_network_reason_virtual_station_blocking_use` 仮想ステーションがアクティブであり、操作をブロックしています。
`wlan_hosted_network_reason_service_available_on_virtual_station` 仮想ステーションでは、同一のサービスを使用できます。

注釈

WLAN_HOSTED_NETWORK_REASON列挙型は、Windows 7 以降のワイヤレスホステッドネットワークをサポートするために追加されたネイティブワイヤレス API の拡張機能です。

WLAN_HOSTED_NETWORK_REASONは、ワイヤレスホスト型ネットワーク関数呼び出しが失敗した可能性のある理由、または特定のワイヤレスホスト型ネットワーク通知が生成された理由を列挙します。

Windows 7 以降では、ホスト型ネットワーク対応ワイヤレスアダプターがコンピューターに存在する場合、オペレーティングシステムによって仮想デバイスがインストールされます。通常、この仮想デバイスは、コンピューターに 1 つのワイヤレスネットワークアダプターがある場合、"ネットワーク接続フォルダー" に "ワイヤレスネットワーク接続 2" と表示され、デバイス名は "Microsoft Virtual WiFi ミニポートアダプター" になります。この仮想デバイスは、ソフトウェアアクセスポイント (SoftAP) 接続の実行専用に使用され、 WlanEnumInterfaces 関数によって返されるリストには存在しません。この仮想デバイスの有効期間は、物理ワイヤレスアダプターに関連付けられています。物理ワイヤレスアダプターが無効になっている場合、この仮想デバイスも削除されます。

要件


サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
Header	wlanapi.h (Wlanapi.h を含む)