Méthode CFrameworkQuery ::GetValuesForProp(LPCWSTR,std.vector<_bstr_t>&) (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,
  std::vector<_bstr_t>& vectorNames
);

Paramètres

wszPropName

Nom de la propriété cible.

vectorNames

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

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 qui seraient retournées par GetValuesForProp pour diverses requêtes lorsqu’elles sont appelées avec wszPropName défini sur « Drive ».

Requête	Valeur retournée	Résultats
SELECT * FROM Win32_Directory Where Drive = « C : »	WBEM_S_NO_ERROR	C :
SELECT * FROM Win32_Directory WHERE Drive = « C : » OR FileSize = 256	WBEM_S_NO_ERROR	Aucun résultat ; aszNames est vide.
SELECT * FROM Win32_Directory WHERE Drive = « C : » OR Drive = « D : »	WBEM_S_NO_ERROR	C :, D :
SELECT * FROM Win32_Directory Where Drive <> « C : »	WBEM_S_NO_ERROR	Aucun résultat ; aszNames est vide.
SELECT * FROM Win32_Directory WHERE Path = « \DOS »	WBEM_S_NO_ERROR	Aucun résultat ; aszNames est vide.

 

La méthode GetValuesForProp prend uniquement en charge les types de chaînes.

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

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