Méthode IWMDMMetaData ::QueryByName (mswmdm.h)

Article
02/29/2024

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 :