Função WcmQueryProperty (wcmapi.h)
A função WcmQueryProperty recupera o valor de uma propriedade WCM especificada.
Sintaxe
DWORD WcmQueryProperty(
[in, optional] const GUID *pInterface,
[in, optional] LPCWSTR strProfileName,
[in] WCM_PROPERTY Property,
void *pReserved,
[out] PDWORD pdwDataSize,
[out] PBYTE *ppData
);
Parâmetros
[in, optional] pInterface
Tipo: const GUID*
A interface a ser consultada. Para propriedades globais, esse parâmetro é NULL.
[in, optional] strProfileName
Tipo: LPCWSTR
O nome do perfil. Se estiver consultando uma propriedade não global (connection_cost, dataplan_status ou hotspot_profile), o perfil deverá ser especificado ou a chamada falhará.
[in] Property
Tipo: WCM_PROPERTY
A propriedade WCM a ser consultada.
pReserved
Tipo: PVOID
Reservado.
[out] pdwDataSize
Tipo: PDWORD
O tamanho do valor da propriedade retornada.
[out] ppData
Tipo: PBYTE*
O valor da propriedade retornada.
Valor retornado
Tipo: DWORD
Retorna ERROR_SUCCESS se tiver êxito ou um valor de erro caso contrário.
Comentários
O tipo de dados armazenados no parâmetro ppData variará, dependendo de qual propriedade está sendo consultada. Esta tabela mostra o tipo de dados de cada propriedade.
| Nome da propriedade | Tipo de dados |
|---|---|
| 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 | Contém saída de comprimento zero. |
Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wcmapi.h |
| Biblioteca | Wcmapi.lib |
| DLL | Wcmapi.dll |