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 |
|
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 |