IWMDMMetaData::AddItem-Methode (mswmdm.h)

Die AddItem-Methode fügt der Schnittstelle eine Metadateneigenschaft hinzu.

Syntax

HRESULT AddItem(
  [in] WMDM_TAG_DATATYPE Type,
  [in] LPCWSTR           pwszTagName,
  [in] BYTE              *pValue,
  [in] UINT              iLength
);

Parameter

[in] Type

Ein WMDM_TAG_DATATYPE aufgezählten Wert, der den Typ der gespeicherten Metadaten angibt.

[in] pwszTagName

Zeiger auf eine Breitzeichenzeichenfolge mit NULL-Beendigung, die den Namen der festzulegenden Eigenschaft angibt. Eine Liste der Standardeigenschaftennamenkonstanten wird in Metadatenkonstanten angegeben.

[in] pValue

Zeiger auf ein Bytearray, das den Wert angibt, der der Eigenschaft zugewiesen werden soll. Der übermittelte Wert wird kopiert, sodass der Arbeitsspeicher nach dem Aufruf von AddItem freigegeben werden kann.

[in] iLength

Ganze Zahl, die die Größe von pValue in Bytes angibt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

  • Com-Standardfehlercodes
  • In HRESULT-Werte konvertierte Windows-Fehlercodes
  • Windows Media Geräte-Manager Fehlercodes
Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IWMDMMetaData-Schnittstelle

Metadatenkonstanten

Festlegen von Metadaten für eine Datei