IPortableDeviceContent2::UpdateObjectWithPropertiesAndData-Methode (portabledeviceapi.h)

Artikel
03/01/2024

Die UpdateObjectWithPropertiesAndData-Methode aktualisiert ein Objekt mithilfe von Eigenschaften und Daten, die auf dem Gerät gefunden werden.

Syntax

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

Parameter

[in] pszObjectID

Der Bezeichner des zu aktualisierenden Objekts.

[in] pProperties

Die IPortableDeviceValues-Schnittstelle , die die zu aktualisierenden Objekteigenschaften angibt.

[out] ppData

Die IStream-Schnittstelle , über die die Objektdaten an das Gerät gesendet werden.

[in, out] pdwOptimalWriteBufferSize

Die optimale Puffergröße zum Schreiben der Objektdaten in ppData oder NULL , wenn die Puffergröße ignoriert wird.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Jeder andere HRESULT-Wert gibt an, dass beim Aufruf ein Fehler aufgetreten ist.

Hinweise

Geräteformate und Objektformate können einige ihrer Objekteigenschaften aus den Daten selbst ableiten. Oder sie können Eigenschaftenwerte aufweisen, die von den Daten abhängen. Beispielsweise verfügt ein Musiktitel über eine duration-Eigenschaft, die angegeben wird, wenn eine Anwendung die IPortableDeviceContent::CreateObjectWithPropertiesAndData-Methode aufruft. Wenn diese Spur als Standardressource (WPD_RESOURCE_DEFAULT) gespeichert wird, wird sie möglicherweise von der Anwendung aktualisiert. Die Anwendung muss möglicherweise auch die duration-Eigenschaft aktualisieren. Mit dieser Methode kann die Anwendung beide Updates gleichzeitig ausführen.

Ein Update ist unvollständig, bis die IStream::Commit-Methode für das Objekt aufgerufen wird, auf das vom ppData-Parameter verwiesen wird.

Um eine laufende Datenübertragung abzubrechen, sollte eine Anwendung die IStream::Revert-Methode für das Objekt aufrufen, auf das vom ppData-Parameter verwiesen wird.

Das IStream-Schnittstellenobjekt , auf das vom ppData-Parameter verwiesen wird, muss freigegeben werden, nachdem der Aktualisierungsvorgang abgeschlossen ist oder abgebrochen wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h

Freigeben über