Condividi tramite


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