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 |
|---|---|
|
Il metodo è riuscito. |
|
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 |