Méthode IWbemPropertyProvider ::GetProperty (wbemprov.h)

La méthode IWbemPropertyProvider ::GetProperty est appelée par Windows Management pour récupérer une valeur de propriété individuelle.

Syntaxe

HRESULT GetProperty(
  [in]  long       lFlags,
  [in]  const BSTR strLocale,
  [in]  const BSTR strClassMapping,
  [in]  const BSTR strInstMapping,
  [in]  const BSTR strPropMapping,
  [out] VARIANT    *pvValue
);

Paramètres

[in] lFlags

Réservé. Ce paramètre doit être 0.

[in] strLocale

Chaîne indiquant les paramètres régionaux souhaités dans les cas où la valeur de propriété retournée peut être localisée. Si la propriété ne peut pas être localisée, l’implémentation peut ignorer cette valeur.

[in] strClassMapping

Copie littérale de la valeur de chaîne pour le qualificateur ClassContext de la classe. Cela pointe vers un BSTR valide, qui est traité en lecture seule ou NULL si le qualificateur n’existe pas.

[in] strInstMapping

Copie littérale de la valeur de chaîne pour le qualificateur InstanceContext pour le instance. Cela doit pointer vers un BSTR valide, qui est traité comme en lecture seule, ou NULL si le qualificateur n’existe pas.

[in] strPropMapping

Copie littérale de la valeur du qualificateur PropertyContext pour la propriété. Cela doit pointer vers un BSTR valide, qui est traité comme en lecture seule, ou NULL si le qualificateur n’existe pas.

[out] pvValue

Pointeur vers un VARIANT non initialisé qui reçoit la valeur de la propriété. L’implémentation doit appeler VariantInit et retourner la valeur. Si une erreur se produit, l’implémentation est censée ignorer le pointeur.

Valeur retournée

Cette méthode doit retourner WBEM_S_NO_ERROR si l’appel réussit. Si l’appel échoue, la méthode doit retourner WBEM_S_FALSE.

Configuration requise

Voir aussi

Construction de fournisseurs de propriétés

IWbemPropertyProvider

PutProperty