IPortableDeviceResources ::GetResourceAttributes, méthode (portabledeviceapi.h)

Article
07/16/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

Une REFPROPERTYKEY qui spécifie la ressource à interroger.

[out] ppResourceAttributes

Pointeur vers un pointeur IPortableDeviceValues pointeur d’interface qui contient PROPERTYKEY/paires PROPVARIANT qui décrivent chaque attribut et sa valeur, respectivement. Les types de valeurs des valeurs d’attribut varient. Si une propriété n’a pas pu être retournée, la valeur de la propriété retournée est VT_ERROR, et le PROPVARIANTmembre de code contient le HRESULT de cet échec particulier.

Valeur de retour

La méthode retourne une HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.

Retourner le code	Description
S_OK	Toutes les valeurs d’attribut ont été récupérées.
S_FALSE	Impossible de récupérer une ou plusieurs valeurs d’attribut. Ces valeurs auront HRESULT valeurs de type VT_ERROR dans le paramètre ppResourceAttributes récupéré.
E_POINTER	Au moins l’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 de bits, le nombre de canaux et le format de données de l’audio.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	portabledeviceapi.h
bibliothèque	PortableDeviceGUIDs.lib

Voir aussi

interface IPortableDeviceResources

Partager via