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 |