WLAN_SECURABLE_OBJECT列挙 (wlanapi.h)
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_controlWLAN ドライバーまたはサービスの独立したハードウェア ベンダー (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_extensibilityWindows 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 |
関連項目
WlanSetInterface