MÉTHODE IMDSPStorage4 ::GetSpecifiedMetadata (mswmdm.h)

La méthode GetSpecifiedMetadata récupère uniquement l’objet de métadonnées spécifié pour un stockage.

Syntaxe

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

Paramètres

[in] cProperties

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

[in] ppwszPropNames

Tableau qui contient les noms de propriétés à récupérer. La taille de ce tableau doit être égale à cProperties.

[out] pMetadata

Pointeur vers le pointeur d’interface IWMDMMetaData retourné.

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

Remarques

Cette méthode permet au client de contrôler les propriétés récupérées. Le client peut spécifier les noms de propriétés pour les propriétés que le client doit récupérer.

En revanche, la méthode GetMetadata récupère toutes les métadonnées de stockage (propriétés).

Si aucune des propriétés spécifiées ne peut être retournée, le fournisseur de services doit retourner WMDM_E_NOTSUPPORTED ou tout code d’erreur approprié.

Si au moins une propriété peut être récupérée, le fournisseur de services doit retourner cette propriété et définir le code de retour sur un code de réussite de WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED.

Configuration requise

Voir aussi

IMDSPStorage4 Interface