Méthode IPortableDeviceCapabilities::GetFunctionalObjects (portabledeviceapi.h)

Article
08/25/2023

La méthode GetFunctionalObjects récupère tous les objets fonctionnels qui correspondent à une catégorie spécifiée sur l’appareil.

Syntaxe

HRESULT GetFunctionalObjects(
  [in]  REFGUID                              Category,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

Paramètres

[in] Category

REFGUID qui spécifie la catégorie à rechercher. Cela peut être WPD_FUNCTIONAL_CATEGORY_ALL pour retourner tous les objets fonctionnels.

[out] ppObjectIDs

Adresse d’une variable qui reçoit un pointeur vers une interface IPortableDevicePropVariantCollection qui contient les ID d’objet des objets fonctionnels sous forme de chaînes (tapez VT_LPWSTR dans les éléments PROPVARIANT récupérés). Si aucun objet du type demandé n’est trouvé, il s’agit d’une collection vide (et non NULL). L’appelant doit libérer cette interface lorsqu’il a terminé avec elle.

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	S_OK

Notes

Cette opération est généralement rapide, car le pilote n’a pas besoin d’effectuer une énumération de contenu complète et le nombre d’objets fonctionnels récupérés est généralement inférieur à 10. Si aucun objet du type demandé n’est trouvé, cette méthode ne retourne pas d’erreur, mais retourne une collection vide pour les ppObjectIDs.