Méthode IWMDMMetaData ::QueryByName (mswmdm.h)
La méthode QueryByName récupère la valeur d’une propriété spécifiée par name.
Syntaxe
HRESULT QueryByName(
[in] LPCWSTR pwszTagName,
[out] WMDM_TAG_DATATYPE *pType,
[out] BYTE **pValue,
[out] UINT *pcbLength
);
Paramètres
[in] pwszTagName
Pointeur vers une chaîne de caractères larges terminée par un caractère Null spécifiant le nom de la propriété. Une liste de constantes de nom de propriété standard est donnée dans Constantes de métadonnées.
[out] pType
Valeur WMDM_TAG_DATATYPE énumérée décrivant le type de données récupérées par pValue.
[out] pValue
Pointeur vers un pointeur vers un tableau d’octets qui reçoit le contenu de la valeur si la méthode réussit. Windows Media Gestionnaire de périphériques alloue cette mémoire et l’appelant doit la libérer à l’aide de CoTaskMemFree.
[out] pcbLength
Pointeur vers la taille, en octets, du tableau d’octets ppValue. Si la valeur est une chaîne, cela inclut le caractère d’arrêt.
Valeur retournée
Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes suivantes de codes d’erreur :
- Codes d’erreur COM standard
- Codes d’erreur Windows convertis en valeurs HRESULT
- Codes d’erreur Gestionnaire de périphériques Windows Media
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |