Méthode IWMDMStorage4 ::GetSpecifiedMetadata (mswmdm.h)

Article
02/29/2024

La méthode GetSpecifiedMetadata récupère une ou plusieurs propriétés de métadonnées spécifiques du stockage.

Syntaxe

HRESULT GetSpecifiedMetadata(
  [in]  DWORD         cProperties,
  [in]  LPCWSTR       *ppwszPropNames,
  [out] IWMDMMetaData **ppMetadata
);

Paramètres

[in] cProperties

Nombre de propriétés à récupérer.

[in] ppwszPropNames

Tableau de noms de propriétés à récupérer. La longueur de ce tableau doit être égale à cProperties. L’application doit libérer cette mémoire à l’aide de CoTaskMemFree.

[out] ppMetadata

Pointeur vers le pointeur d’interface IWMDMMetaData retourné, contenant les valeurs récupérées. L’appelant doit libérer cette interface quand il en a terminé.

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

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Cette méthode permet au client de contrôler les propriétés récupérées. Cela peut être plus efficace que IWMDMStorage3 ::GetMetadata et est recommandé lorsque le client n’a besoin que d’un sous-ensemble de propriétés prises en charge par le stockage.

Si cette méthode est utilisée pour récupérer des données à partir d’un appareil WPD (Windows Portable Devices), les données sont retournées sous forme binaire dans un objet IPortableDeviceValues . L’application doit désérialiser ces données afin d’obtenir les valeurs de propriété réelles.

La méthode réussit et retourne WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED même si certaines propriétés spécifiées n’ont pas pu être récupérées (mais au moins une propriété a été récupérée). La méthode échoue et retourne WMDM_E_NOTSUPPORTED si aucune des propriétés spécifiées n’a pu être récupérée.

La demande d’une propriété unique est un cas particulier de cette méthode. Si le client demande une seule propriété, les codes de retour possibles sont S_OK, E_INVALIDARG et WMDM_E_NOTSUPPORTED. Ainsi, dans le cas d’une propriété unique, la méthode réussit uniquement si la propriété est récupérée avec succès.