Compartilhar via

Função WcmSetProperty (wcmapi.h)

  • Artigo

A função WcmSetProperty define o valor de uma propriedade WCM.

Sintaxe

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
);

Parâmetros

[in, optional] pInterface

Tipo: const GUID*

A interface a ser definida. Para propriedades globais, esse parâmetro é NULL.

[in, optional] strProfileName

Tipo: LPCWSTR

O nome do perfil.

[in] Property

Tipo: WCM_PROPERTY

A propriedade WCM a ser definida.

pReserved

Tipo: PVOID

Reservado.

[in] dwDataSize

Tipo: DWORD

O tamanho do novo valor da propriedade.

[in, optional] pbData

Tipo: const BYTE*

O novo valor da propriedade.

Retornar valor

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 pbData variará, dependendo de qual propriedade está sendo definida. 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 Cadeia de caracteres XML de comprimento variável. Consulte o esquema HotSpotProfile para obter mais informações.

Requisitos

Requisito Valor
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

Confira também

Esquema HotSpotProfile

WCM_PROPERTY