Share via

IMFAttributes::SetItem-Methode (mfobjects.h)

  • Artikel

Fügt einen Attributwert mit einem angegebenen Schlüssel hinzu.

Syntax

HRESULT SetItem(
  [in] REFGUID        guidKey,
  [in] REFPROPVARIANT Value
);

Parameter

[in] guidKey

Eine GUID, die den festzulegenden Wert identifiziert. Wenn dieser Schlüssel bereits vorhanden ist, überschreibt die -Methode den alten Wert.

[in] Value

Ein PROPVARIANT , der den Attributwert enthält. Die -Methode kopiert den Wert. Der PROPVARIANT-Typ muss einer der in der MF_ATTRIBUTE_TYPE-Enumeration aufgeführten Typen sein.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.
MF_E_INVALIDTYPE
 Ungültiger Attributtyp.

Hinweise

Diese Methode überprüft, ob der PROPVARIANT-Typ einer der in MF_ATTRIBUTE_TYPE definierten Attributtypen ist, und schlägt fehl, wenn ein nicht unterstützter Typ verwendet wird. Diese Methode überprüft jedoch nicht, ob PROPVARIANT der richtige Typ für die angegebene Attribut-GUID ist. (Es gibt keine programmgesteuerte Möglichkeit, Attribut-GUIDs eigenschaftentypen zuzuordnen.) Eine Liste der Media Foundation-Attribute und deren Datentypen finden Sie unter Media Foundation-Attribute.

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

Attribute und Eigenschaften

IMFAttributes