通过

WcmQueryProperty 函数 (wcmapi.h)

WcmQueryProperty 函数检索指定 WCM 属性的值。

语法

DWORD WcmQueryProperty(
  [in, optional] const GUID   *pInterface,
  [in, optional] LPCWSTR      strProfileName,
  [in]           WCM_PROPERTY Property,
                 void         *pReserved,
  [out]          PDWORD       pdwDataSize,
  [out]          PBYTE        *ppData
);

参数

[in, optional] pInterface

类型： const GUID*

要查询的接口。 对于全局属性，此参数为 NULL。

[in, optional] strProfileName

类型： LPCWSTR

配置文件的名称。 如果查询非全局属性 (connection_cost、 dataplan_status或 hotspot_profile) ，则必须指定配置文件，否则调用将失败。

[in] Property

类型： WCM_PROPERTY

要查询的 WCM 属性。

pReserved

类型： PVOID

保留。

[out] pdwDataSize

类型： PDWORD

返回的属性值的大小。

[out] ppData

类型： PBYTE*

返回的属性值。

返回值

类型：DWORD

如果成功，则返回ERROR_SUCCESS，否则返回错误值。

注解

存储在 ppData 参数中的数据的类型会有所不同，具体取决于要查询的属性。 此表显示每个属性的数据类型。

属性名称 数据类型
wcm_global_property_domain_policy WCM_POLICY_VALUE
wcm_global_property_minimize_policy WCM_POLICY_VALUE
wcm_global_property_roaming_policy WCM_POLICY_VALUE
wcm_global_property_powermanagement_policy WCM_POLICY_VALUE
wcm_intf_property_connection_cost WCM_CONNECTION_COST_DATA
wcm_intf_property_dataplan_status WCM_DATAPLAN_STATUS
wcm_intf_property_hotspot_profile 包含零长度输出。

要求

   
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 wcmapi.h
Library Wcmapi.lib
DLL Wcmapi.dll

另请参阅

WCM_PROPERTY

  • Last updated on