WLAN_SECURABLE_OBJECT列挙 (wlanapi.h)

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

WLAN_SECURABLE_OBJECT列挙型は、Native Wifi Functions で使用されるセキュリティ保護可能なオブジェクトを定義します。

これらのオブジェクトは、 WlanSetSecuritySettings を使用してセキュリティで保護できます。これらのオブジェクトに関連付けられている現在のアクセス許可は、 WlanGetSecuritySettings を使用して取得できます。セキュリティ保護可能なオブジェクトの使用の詳細については、「 DACL がオブジェクトへのアクセスを制御する方法」を参照してください。

構文

typedef enum _WLAN_SECURABLE_OBJECT {
  wlan_secure_permit_list = 0,
  wlan_secure_deny_list,
  wlan_secure_ac_enabled,
  wlan_secure_bc_scan_enabled,
  wlan_secure_bss_type,
  wlan_secure_show_denied,
  wlan_secure_interface_properties,
  wlan_secure_ihv_control,
  wlan_secure_all_user_profiles_order,
  wlan_secure_add_new_all_user_profiles,
  wlan_secure_add_new_per_user_profiles,
  wlan_secure_media_streaming_mode_enabled,
  wlan_secure_current_operation_mode,
  wlan_secure_get_plaintext_key,
  wlan_secure_hosted_network_elevated_access,
  wlan_secure_virtual_station_extensibility,
  wlan_secure_wfd_elevated_access,
  WLAN_SECURABLE_OBJECT_COUNT
} WLAN_SECURABLE_OBJECT, *PWLAN_SECURABLE_OBJECT;

定数


`wlan_secure_permit_list` 値: 0 ユーザープロファイルの許可リストを変更するためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている随意アクセス制御リスト (DACL) は、wlanFilterListType を wlan_filter_list_type_user_permitに設定してWlanGetFilterList または WlanSetFilterList を呼び出すと取得されます。 WlanGetFilterList 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンに対するアクセス許可WLAN_READ_ACCESS付与するアクセス制御エントリ (ACE) が含まれている必要があります。 WlanSetFilterList の呼び出しが成功するには、DACL に、呼び出し元スレッドのアクセストークンに対するアクセス許可WLAN_WRITE_ACCESS付与する ACE が含まれている必要があります。
`wlan_secure_deny_list` ユーザープロファイルの拒否リストを変更するためのアクセス許可。自動構成サービスは、拒否リスト上のネットワークへの接続を確立しません。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、wlanFilterListType が wlan_filter_list_type_user_deny に設定された WlanGetFilterList または WlanSetFilterList が呼び出されたときに取得されます。 WlanGetFilterList の呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンにWLAN_READ_ACCESSアクセス許可を付与する ACE が含まれている必要があります。 WlanSetFilterList の呼び出しが成功するには、DACL に、呼び出し元スレッドのアクセストークンに対するアクセス許可WLAN_WRITE_ACCESS付与する ACE が含まれている必要があります。
`wlan_secure_ac_enabled` 自動構成サービスを有効にするためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、OpCode を wlan_intf_opcode_autoconf_enabled に設定して WlanQueryInterface または WlanSetInterface が呼び出されたときに取得されます。 WlanQueryInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_READ_ACCESSアクセス許可を付与する ACE が含まれている必要があります。 WlanSetInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_WRITE_ACCESSアクセス許可を付与する ACE が含まれている必要があります。
`wlan_secure_bc_scan_enabled` バックグラウンドスキャンを有効にするためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、OpCode を wlan_intf_opcode_background_scan_enabled に設定して WlanQueryInterface または WlanSetInterface が呼び出されたときに取得されます。 WlanQueryInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_READ_ACCESSアクセス許可を付与する ACE が含まれている必要があります。 WlanSetInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_WRITE_ACCESSアクセス許可を付与する ACE が含まれている必要があります。
`wlan_secure_bss_type` 基本的なサービスセットの種類を変更するためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、OpCode を wlan_intf_opcode_bss_type に設定して WlanQueryInterface または WlanSetInterface が呼び出されたときに取得されます。 WlanQueryInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_READ_ACCESSアクセス許可を付与する ACE が含まれている必要があります。 WlanSetInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_WRITE_ACCESSアクセス許可を付与する ACE が含まれている必要があります。
`wlan_secure_show_denied` 拒否リストのネットワークが使用可能なネットワークの一覧に表示されるかどうかを変更するためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、OpCode を wlan_autoconf_opcode_show_denied_networks に設定して WlanQueryAutoConfigParameter または WlanSetAutoConfigParameter が呼び出されたときに取得されます。 WlanQueryAutoConfigParameter 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_READ_ACCESSアクセス許可を付与する ACE が含まれている必要があります。 WlanSetAutoConfigParameter 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンに対するアクセス許可WLAN_WRITE_ACCESS付与する ACE が含まれている必要があります。
`wlan_secure_interface_properties` インターフェイスのプロパティを変更するためのアクセス許可。これは、別の特定のセキュリティ保護可能なオブジェクトが使用されていない場合に、WlanQueryInterface または WlanSetInterface によって使用される汎用のセキュリティ保護可能なオブジェクトです。その DACL は、WlanQueryInterface または WlanSetInterface が呼び出し元スレッドのアクセストークンであり、OpCode が wlan_intf_opcode_autoconf_enabled、wlan_intf_opcode_background_scan_enabled、wlan_intf_opcode_media_streaming_mode、wlan_intf_opcode_bss_type、またはwlan_intf_opcode_current_operation_mode以外の値に設定されるたびに取得されます。また、OpCode が wlan_intf_opcode_radio_state に設定されていて、呼び出し元がコンソールユーザーである場合も、DACL は取得されません。 WlanQueryInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_READ_ACCESSアクセス許可を付与する ACE が含まれている必要があります。 WlanSetInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_WRITE_ACCESSアクセス許可を付与する ACE が含まれている必要があります。
`wlan_secure_ihv_control` WLAN ドライバーまたはサービスの独立したハードウェアベンダー (IHV) 制御に WlanIhvControl 関数を使用するためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、 WlanIhvControl が呼び出されたときに取得されます。呼び出しを成功させるには、呼び出し元スレッドのアクセストークンにWLAN_WRITE_ACCESSアクセス許可を付与する ACE が DACL に含まれている必要があります。
`wlan_secure_all_user_profiles_order` すべてのユーザープロファイルの順序を変更するためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、 WlanSetProfileList または WlanSetProfilePosition がプロファイルリスト内の全ユーザープロファイルの相対順序を変更する操作を実行する前に取得されるか、またはプロファイルリスト内の下位の位置に全ユーザープロファイルを移動する操作を実行します。いずれかの呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_WRITE_ACCESSアクセス許可を付与する ACE が含まれている必要があります。
`wlan_secure_add_new_all_user_profiles` 新しいすべてのユーザープロファイルを追加するためのアクセス許可。メモこのオブジェクトに関連付けられているセキュリティ記述子は、作成された新しいすべてのユーザープロファイルに適用されます。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、dwFlags を 0 に設定して WlanSetProfile を呼び出すと取得されます。呼び出しを成功させるには、呼び出し元スレッドのアクセストークンにWLAN_WRITE_ACCESSアクセス許可を付与する ACE が DACL に含まれている必要があります。
`wlan_secure_add_new_per_user_profiles` 新しいユーザーごとのプロファイルを追加するためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、dwFlags が WLAN_PROFILE_USER に設定された WlanSetProfile が呼び出されたときに取得されます。呼び出しを成功させるには、呼び出し元スレッドのアクセストークンにWLAN_WRITE_ACCESSアクセス許可を付与する ACE が DACL に含まれている必要があります。
`wlan_secure_media_streaming_mode_enabled` メディアストリーミングモードを設定またはクエリするためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、OpCode を wlan_intf_opcode_media_streaming_mode に設定して WlanQueryInterface または WlanSetInterface が呼び出されたときに取得されます。 WlanQueryInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_READ_ACCESSアクセス許可を付与する ACE が含まれている必要があります。 WlanSetInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_WRITE_ACCESSアクセス許可を付与する ACE が含まれている必要があります。
`wlan_secure_current_operation_mode` ワイヤレスインターフェイスの操作モードを設定またはクエリするためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、OpCode を wlan_intf_opcode_current_operation_mode に設定して WlanQueryInterface または WlanSetInterface が呼び出されたときに取得されます。 WlanQueryInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_READ_ACCESSアクセス許可を付与する ACE が含まれている必要があります。 WlanSetInterface 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_WRITE_ACCESSアクセス許可を付与する ACE が含まれている必要があります。
`wlan_secure_get_plaintext_key` ワイヤレスプロファイルからプレーンテキストキーを取得するためのアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、入力時に pdwFlags パラメーターが指す値に設定されたWLAN_PROFILE_GET_PLAINTEXT_KEY フラグを使用して WlanGetProfile 関数が呼び出されたときに取得されます。 WlanGetProfile 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンに対するアクセス許可WLAN_READ_ACCESS付与する ACE が含まれている必要があります。既定では、プレーンテキストキーを取得するためのアクセス許可は、ローカルコンピューターの Administrators グループのメンバーにのみ許可されます。 Windows 7: この値は、Windows 7 以降で追加されたネイティブワイヤレス API の拡張機能です。
`wlan_secure_hosted_network_elevated_access` 特権 Hosted Network 関数を呼び出す昇格されたアクセス許可。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、OpCode パラメーターを wlan_hosted_network_opcode_enable に設定して WlanHostedNetworkSetProperty 関数が呼び出されたときに取得されます。 WlanHostedNetworkSetProperty 呼び出しを成功させるには、DACL に、呼び出し元スレッドのアクセストークンWLAN_WRITE_ACCESSアクセス許可を付与する ACE が含まれている必要があります。既定では、ワイヤレス Hosted Network プロパティを wlan_hosted_network_opcode_enable に設定するアクセス許可は、ローカルコンピューター上の Administrators グループのメンバーにのみ許可されます。このセキュリティ保護可能なオブジェクトに関連付けられている DACL は、 WlanHostedNetworkForceStart 関数が呼び出されたときに取得されます。 WlanHostedNetworkForceStart 呼び出しが成功するには、DACL に、呼び出し元スレッドのアクセストークンWLAN_WRITE_ACCESSアクセス許可を付与する ACE が含まれている必要があります。既定では、ワイヤレスホスト型ネットワークを強制的に起動するアクセス許可は、ローカルコンピューター上の Administrators グループのメンバーにのみ許可されます。 Windows 7: この値は、Windows 7 以降で追加されたネイティブワイヤレス API の拡張機能です。
`wlan_secure_virtual_station_extensibility` Windows 7: この値は、Windows 7 以降で追加されたネイティブワイヤレス API の拡張機能です。
`wlan_secure_wfd_elevated_access` この値は、Wi-Fi Direct サービスで内部使用するために予約されています。 Windows 8: この値は、Windows 8 以降で追加されたネイティブワイヤレス API の拡張機能です。
`WLAN_SECURABLE_OBJECT_COUNT`

解説

これらのオブジェクトは、 WlanSetSecuritySettings を使用してセキュリティで保護できます。これらのオブジェクトに関連付けられている現在のアクセス許可は、 WlanGetSecuritySettings を使用して取得できます。セキュリティ保護可能なオブジェクトの使用の詳細については、「 DACLs がオブジェクトへのアクセスを制御する方法」および「ネイティブ Wifi API のアクセス許可」を参照してください。

要件


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
Header	wlanapi.h

次の方法で共有

WLAN_SECURABLE_OBJECT列挙 (wlanapi.h)

構文

定数

解説

要件

関連項目

フィードバック

その他のリソース