Функция WcmSetProperty (wcmapi.h)
Функция 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 |
| Header | wcmapi.h |
| Библиотека | wcmapi.lib |
| DLL | Wcmapi.dll |