Функция 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

См. также раздел

Схема HotSpotProfile

WCM_PROPERTY