Metodo IPortableDeviceContent2::UpdateObjectWithPropertiesAndData (portabledeviceapi.h)

Articolo
03/01/2024

Il metodo UpdateObjectWithPropertiesAndData aggiorna un oggetto usando le proprietà e i dati trovati nel dispositivo.

Sintassi

HRESULT UpdateObjectWithPropertiesAndData(
  [in]      LPCWSTR               pszObjectID,
  [in]      IPortableDeviceValues *pProperties,
  [out]     IStream               **ppData,
  [in, out] DWORD                 *pdwOptimalWriteBufferSize
);

Parametri

[in] pszObjectID

Identificatore dell'oggetto da aggiornare.

[in] pProperties

Interfaccia IPortableDeviceValues che specifica le proprietà dell'oggetto da aggiornare.

[out] ppData

Interfaccia IStream tramite cui i dati dell'oggetto vengono inviati al dispositivo.

[in, out] pdwOptimalWriteBufferSize

Dimensioni ottimali del buffer per la scrittura dei dati dell'oggetto in ppData o NULL se le dimensioni del buffer vengono ignorate.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK. Qualsiasi altro valore HRESULT indica che la chiamata non è riuscita.

Commenti

I formati di dispositivo e gli oggetti possono derivare alcune delle proprietà dell'oggetto dai dati stessi. In alternativa, possono avere valori di proprietà che dipendono dai dati. Ad esempio, una traccia musicale ha una proprietà duration specificata quando un'applicazione chiama il metodo IPortableDeviceContent::CreateObjectWithPropertiesAndData . Se questa traccia viene archiviata come risorsa predefinita (WPD_RESOURCE_DEFAULT), l'applicazione potrebbe aggiornarla. L'applicazione potrebbe inoltre comportarsi per aggiornare la proprietà duration. Questo metodo consente all'applicazione di eseguire entrambi gli aggiornamenti contemporaneamente.

Un aggiornamento è incompleto finché il metodo IStream::Commit non viene chiamato sull'oggetto a cui fa riferimento il parametro ppData .

Per abbandonare un trasferimento dei dati in corso, un'applicazione deve chiamare il metodo IStream::Revert sull'oggetto a cui fa riferimento il parametro ppData .

L'oggetto interfaccia IStream a cui fa riferimento il parametro ppData deve essere rilasciato dopo il completamento dell'operazione di aggiornamento oppure viene annullato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h

Condividi tramite