Méthode IPortableDeviceContent ::CreateObjectWithPropertiesOnly (portabledeviceapi.h)

Article
03/04/2024

La méthode CreateObjectWithPropertiesOnly crée un objet avec uniquement des propriétés sur l’appareil.

Syntaxe

HRESULT CreateObjectWithPropertiesOnly(
            IPortableDeviceValues *pValues,
  [in, out] LPWSTR                *ppszObjectID
);

Paramètres

pValues

Collection IPortableDeviceValues de propriétés à affecter à l’objet. Pour obtenir la liste des propriétés obligatoires et facultatives d’un objet, consultez Configuration requise pour les objets.

[in, out] ppszObjectID

Pointeur de chaîne facultatif pour recevoir le nom du nouvel objet. Peut être NULL, si ce n’est pas nécessaire. Les appareils portables Windows définissent la constante WPD_DEVICE_OBJECT_ID pour représenter un appareil. Le Kit de développement logiciel (SDK) alloue cette mémoire ; l’appelant doit le libérer à l’aide de CoTaskMemFree.

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
E_POINTER	Au moins un des arguments requis était un pointeur NULL .

Remarques

Certains objets ne sont qu’une collection de propriétés, comme un dossier, qui n’est qu’une collection de pointeurs vers d’autres objets, tandis que d’autres objets sont à la fois des propriétés et des données, comme un fichier audio, qui contient toutes les propriétés et les bits de musique réels. Cette méthode est utilisée pour créer un objet qui contient uniquement des propriétés. Pour créer un objet avec des propriétés et des données, utilisez CreateObjectWithPropertiesAndData.

Cette méthode est synchrone ; lorsqu’il retourne, le nouvel objet doit être présent sur l’appareil.

L’objet créé par le pilote peut être un objet de propriétés et de données, selon le type d’objet le plus pratique pour le pilote. Pour case activée quel type d’objet le pilote a créé, demandez la propriété WPD_OBJECT_FORMAT du nouvel objet.

L’objet est créé sur l’appareil lorsque cette méthode est retournée.

Exemples

Pour obtenir un exemple d’utilisation de cette méthode, consultez Transfert d’un objet Properties-Only vers l’appareil.

Configuration requise

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

Voir aussi

IPortableDeviceContent, interface

Transfert d’un objet Properties-Only vers l’appareil

Partager via