Funzione WcmSetProperty (wcmapi.h)

Articolo
03/03/2024

La funzione WcmSetProperty imposta il valore di una proprietà WCM.

Sintassi

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

Parametri

[in, optional] pInterface

Tipo: GUID const*

Interfaccia da impostare. Per le proprietà globali, questo parametro è NULL.

[in, optional] strProfileName

Tipo: LPCWSTR

Nome del profilo.

[in] Property

Tipo: WCM_PROPERTY

Proprietà WCM da impostare.

pReserved

Tipo: PVOID

Riservato.

[in] dwDataSize

Tipo: DWORD

Dimensione del nuovo valore della proprietà.

[in, optional] pbData

Tipo: const BYTE*

Nuovo valore della proprietà.

Valore restituito

Tipo: DWORD

Restituisce ERROR_SUCCESS se ha esito positivo o un valore di errore in caso contrario.

Commenti

Il tipo di dati archiviati nel parametro pbData varia a seconda della proprietà impostata. Questa tabella mostra il tipo di dati di ogni proprietà.

Nome proprietà	Tipo di dati
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	Stringa XML a lunghezza variabile. Per altre informazioni, vedere lo schema HotSpotProfile .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wcmapi.h
Libreria	Wcmapi.lib
DLL	Wcmapi.dll

Vedi anche

Schema HotSpotProfile

WCM_PROPERTY

Condividi tramite