Поделиться через

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

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

WCM_PROPERTY