WcmSetProperty, fonction (wcmapi.h)

Article
03/03/2024

La fonction WcmSetProperty définit la valeur d’une propriété WCM.

Syntaxe

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

Paramètres

[in, optional] pInterface

Type : const GUID*

Interface à définir. Pour les propriétés globales, ce paramètre a la valeur NULL.

[in, optional] strProfileName

Type : LPCWSTR

Nom du profil.

[in] Property

Type : WCM_PROPERTY

Propriété WCM à définir.

pReserved

Type : PVOID

Réservé.

[in] dwDataSize

Type : DWORD

Taille de la nouvelle valeur de propriété.

[in, optional] pbData

Type : const BYTE*

Nouvelle valeur de la propriété.

Valeur retournée

Type : DWORD

Retourne ERROR_SUCCESS en cas de réussite, ou une valeur d’erreur dans le cas contraire.

Remarques

Le type de données stockées dans le paramètre pbData varie en fonction de la propriété définie. Ce tableau montre le type de données de chaque propriété.

Nom de la propriété	Type de données
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	Chaîne XML de longueur variable. Pour plus d’informations, consultez le schéma HotSpotProfile .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wcmapi.h
Bibliothèque	Wcmapi.lib
DLL	Wcmapi.dll

Voir aussi

Schéma HotSpotProfile

WCM_PROPERTY

Partager via