Méthode CFrameworkQuery ::GetValuesForProp(LPCWSTR,CHStringArray&) (frquery.h)

[La classe CFrameworkQuery fait partie du framework de fournisseur WMI, qui est maintenant considéré dans son état final, et aucun développement, amélioration ou mise à jour supplémentaire ne sera disponible pour les problèmes non liés à la sécurité affectant ces bibliothèques. Les API MI doivent être utilisées pour tout nouveau développement.]

La méthode GetValuesForProp retourne toutes les valeurs pour une propriété particulière qui sont générées par cette propriété telle qu’elle apparaît dans la requête.

Par exemple, un appel à GetValuesForProp(L"Name", sa) retourne le tableau sa, qui contient toutes les valeurs de « Name » qui nécessitent le renvoi des instances pour satisfaire la requête. Si sa contient {"a","b"}, toutes les instances où « Name=a » et toutes les instances où « Name=b » doivent être renvoyées pour satisfaire complètement la requête.

Si les contraintes sur « Name » ne sont pas suffisamment limitatives, un tableau sa vide est retourné.

Syntaxe

HRESULT GetValuesForProp(
  LPCWSTR         wszPropName,
  CHStringArray & achNames
);

Paramètres

wszPropName

Tableau de valeurs pour la propriété spécifiée par wszPropName.

achNames

Nom de la propriété cible.

Valeur retournée

Cette méthode retourne WBEM_S_NO_ERROR en cas de réussite et WBEM_E_FAILED, ou tout autre code d’erreur HRESULT , en cas d’échec.

Remarques

Avec un nom de propriété, cette méthode retourne toutes les valeurs de résultat dans un chStringArray ou un conteneur de vecteurs. Le conteneur de vecteurs contient _bstr_t objets qui contiennent les valeurs de résultat.

Par exemple, la liste suivante répertorie les valeurs retournées par GetValuesForProp pour une variété de requêtes lorsqu’elles sont appelées avec wszPropName défini sur « Drive ».

Requête	Valeur retournée	Résultats
SELECT * FROMWin32_Directory OÙ Lecteur = « C : »	WBEM_S_NO_ERROR	C :
SELECT * FROMWin32_Directory OÙ Drive = « C : » OR FileSize = 256	WBEM_S_NO_ERROR	Aucun résultat ; aszNames est vide.
SELECT * FROMWin32_Directory OÙ Lecteur = « C : » OR Drive = « D : »	WBEM_S_NO_ERROR	C :, D :
SELECT * FROMWin32_Directory OÙ Lecteur <> « C : »	WBEM_S_NO_ERROR	Aucun résultat ; aszNames est vide.
SELECT * FROMWin32_Directory WHEREPath = « \DOS »	WBEM_S_NO_ERROR	Aucun résultat ; aszNames est vide.

 

La méthode GetValuesForProp prend uniquement en charge les types de chaînes. Par exemple, la requête suivante, suivie d’un appel à GetValuesForProp(« PropInt », values), retourne WBEM_E_INVALID_QUERY tandis que GetValuesForProp(« PropStr », values) retourne S_OK.

SELECT * FROM Test WHERE PropInt = 32 AND PropStr = "a"

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	frquery.h (inclure FwCommon.h)
Bibliothèque	FrameDyn.lib
DLL	FrameDynOS.dll ; FrameDyn.dll

Voir aussi

CFrameworkQuery

Provider ::ExecQuery