Metodo IPortableDeviceResources::CreateResource (portabledeviceapi.h)

Il metodo CreateResource crea una risorsa.

Sintassi

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

Parametri

[in] pResourceAttributes

Puntatore agli attributi dei parametri dell'oggetto seguenti.

Attributo	Descrizione
WPD_OBJECT_NAME	Nome dell'oggetto.
WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE	Dimensioni totali del flusso di dati delle risorse.
WPD_RESOURCE_ATTRIBUTE_FORMAT	Formato del flusso di dati delle risorse.
WPD_RESOURCE_ATTRIBUTE_RESOURCE_KEY	Chiave della risorsa.

[out] ppData

Puntatore a un flusso in cui il chiamante può scrivere i dati delle risorse.

[out] pdwOptimalWriteBufferSize

Puntatore a un valore che specifica le dimensioni ottimali del buffer durante la scrittura nel flusso. Questo parametro è facoltativo e,

[out] ppszCookie

Puntatore a un cookie che identifica la richiesta di creazione delle risorse. Questo parametro è facoltativo e,

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Almeno uno degli argomenti è un puntatore NULL .

Commenti

Quando un'applicazione chiama questo metodo, deve specificare gli attributi delle risorse e deve scrivere i dati necessari nel flusso restituito da questo metodo.

Una risorsa non viene creata quando il metodo restituisce; viene creato quando l'applicazione esegue il commit dei dati chiamando il metodo Commit nel flusso in corrispondenza del quale ppData punta.

Per annullare il trasferimento dei dati in una risorsa, l'applicazione deve chiamare il metodo Revert nel flusso in cui punti ppData . Una volta annullato il trasferimento, l'applicazione deve richiamare IUnknown::Release per chiudere il flusso.

Requisiti

Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDeviceResources