WcmQueryProperty, fonction (wcmapi.h)

La fonction WcmQueryProperty récupère la valeur d’une propriété WCM spécifiée.

Syntaxe

DWORD WcmQueryProperty(
  [in, optional] const GUID   *pInterface,
  [in, optional] LPCWSTR      strProfileName,
  [in]           WCM_PROPERTY Property,
                 void         *pReserved,
  [out]          PDWORD       pdwDataSize,
  [out]          PBYTE        *ppData
);

Paramètres

[in, optional] pInterface

Type : const GUID*

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

[in, optional] strProfileName

Type : LPCWSTR

Nom du profil. Si vous interrogez une propriété non globale (connection_cost, dataplan_status ou hotspot_profile), le profil doit être spécifié ou l’appel échoue.

[in] Property

Type : WCM_PROPERTY

Propriété WCM à interroger.

pReserved

Type : PVOID

Réservé.

[out] pdwDataSize

Type : PDWORD

Taille de la valeur de propriété retournée.

[out] ppData

Type : PBYTE*

Valeur de propriété retournée.

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 ppData varie en fonction de la propriété interrogée. 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	Contient une sortie de longueur nulle.

Configuration requise

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

WCM_PROPERTY