Compartir a través de

Función WcmSetProperty (wcmapi.h)

  • Artículo

La función WcmSetProperty establece el valor de una propiedad WCM.

Sintaxis

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: GUID const*

Interfaz que se va a establecer. Para las propiedades globales, este parámetro es NULL.

[in, optional] strProfileName

Tipo: LPCWSTR

El nombre del perfil.

[in] Property

Tipo: WCM_PROPERTY

La propiedad WCM que se va a establecer.

pReserved

Tipo: PVOID

Reservado.

[in] dwDataSize

Tipo: DWORD

Tamaño del nuevo valor de propiedad.

[in, optional] pbData

Tipo: const BYTE*

Nuevo valor de propiedad.

Valor devuelto

Tipo: DWORD

Devuelve ERROR_SUCCESS si se ejecuta correctamente o un valor de error de lo contrario.

Comentarios

El tipo de datos almacenados en el parámetro pbData variará, en función de la propiedad que se establezca. En esta tabla se muestra el tipo de datos de cada propiedad.

Nombre de propiedad Tipo de datos
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 Cadena XML de longitud variable. Consulte el esquema HotSpotProfile para obtener más información.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wcmapi.h
Library Wcmapi.lib
Archivo DLL Wcmapi.dll

Consulte también

Esquema HotSpotProfile

WCM_PROPERTY