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

La méthode CreateResource crée une ressource.

Syntaxe

HRESULT CreateResource(
  [in]  IPortableDeviceValues *pResourceAttributes,
  [out] IStream               **ppData,
  [out] DWORD                 *pdwOptimalWriteBufferSize,
  [out] LPWSTR                *ppszCookie
);

Paramètres

[in] pResourceAttributes

Pointeur vers les attributs de paramètre d’objet suivants.

Attribut	Description
WPD_OBJECT_NAME	Nom de l'objet.
WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE	Taille totale du flux de données de ressources.
WPD_RESOURCE_ATTRIBUTE_FORMAT	Format du flux de données de ressources.
WPD_RESOURCE_ATTRIBUTE_RESOURCE_KEY	Clé de ressource.

[out] ppData

Pointeur vers un flux dans lequel l’appelant peut écrire des données de ressource.

[out] pdwOptimalWriteBufferSize

Pointeur vers une valeur qui spécifie la taille optimale de la mémoire tampon lors de l’écriture dans le flux. Ce paramètre est facultatif.

[out] ppszCookie

Pointeur vers un cookie qui identifie la demande de création de ressource. Ce paramètre est facultatif.

Valeur renvoyé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 était un pointeur NULL .

Notes

Lorsqu’une application appelle cette méthode, elle doit spécifier les attributs de ressource et écrire les données requises dans le flux que cette méthode retourne.

Une ressource n’est pas créée lorsque la méthode retourne ; il est créé lorsque l’application valide les données en appelant la méthode Commit sur le flux sur lequel pointe ppData .

Pour annuler le transfert de données vers une ressource, l’application doit appeler la méthode Revert sur le flux sur lequel pointe ppData . Une fois le transfert annulé, l’application doit appeler IUnknown::Release pour fermer le flux.

Configuration requise

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

Voir aussi

IPortableDeviceResources, interface