Méthode IPortableDeviceContent ::CreateObjectWithPropertiesOnly (portabledeviceapi.h)
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 |
|
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 |