Méthode IPortableDeviceResources ::GetResourceAttributes (portabledeviceapi.h)

Article
03/01/2024

La méthode GetResourceAttributes récupère tous les attributs d’une ressource spécifiée dans un objet.

Syntaxe

HRESULT GetResourceAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppResourceAttributes
);

Paramètres

[in] pszObjectID

Pointeur vers une chaîne terminée par null qui contient l’ID d’objet de l’objet hébergeant la ressource.

[in] Key

REFPROPERTYKEY qui spécifie la ressource à interroger.

[out] ppResourceAttributes

Pointeur vers un pointeur d’interface IPortableDeviceValues qui contient des pairesPROPVARIANTPROPERTYKEY/ qui décrivent respectivement chaque attribut et sa valeur. Les types de valeurs des attributs varient. Si une propriété n’a pas pu être retournée, la valeur de la propriété retournée sera VT_ERROR et le membre scodePROPVARIANT contiendra le HRESULT de cet échec particulier.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	Toutes les valeurs d’attribut ont été récupérées.
S_FALSE	Une ou plusieurs valeurs d’attribut n’ont pas pu être récupérées. Celles-ci auront des valeurs HRESULT de type VT_ERROR dans le paramètre ppResourceAttributes récupéré.
E_POINTER	Au moins un des arguments de pointeur requis était NULL.

Remarques

Les attributs de ressource décrivent les droits d’accès, la taille, le format et d’autres informations relatives à une ressource. Par exemple, les attributs d’une ressource d’annotation audio sur un objet image peuvent spécifier le débit binaire, le nombre de canaux et le format de données de l’audio.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	portabledeviceapi.h
Bibliothèque	PortableDeviceGUIDs.lib

Voir aussi

IPortableDeviceResources, interface

Share via