WcmSetProperty 函数设置 WCM 属性的值。
语法
DWORD WcmSetProperty(
[in, optional] const GUID *pInterface,
[in, optional] LPCWSTR strProfileName,
[in] WCM_PROPERTY Property,
void *pReserved,
[in] DWORD dwDataSize,
[in, optional] const BYTE *pbData
);
参数
[in, optional] pInterface
类型: const GUID*
要设置的接口。 对于全局属性,此参数为 NULL。
[in, optional] strProfileName
类型: LPCWSTR
配置文件名称。
[in] Property
类型: WCM_PROPERTY
要设置的 WCM 属性。
pReserved
类型: PVOID
保留。
[in] dwDataSize
类型:DWORD
新属性值的大小。
[in, optional] pbData
类型: const BYTE*
新的属性值。
返回值
类型:DWORD
如果成功,则返回ERROR_SUCCESS,否则返回错误值。
注解
pbData 参数中存储的数据类型会有所不同,具体取决于要设置的属性。 此表显示每个属性的数据类型。
| 属性名称 | 数据类型 |
|---|---|
| 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 | 可变长度 XML 字符串。 有关详细信息,请参阅 HotSpotProfile 架构 。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | wcmapi.h |
| Library | Wcmapi.lib |
| DLL | Wcmapi.dll |