IMFAttributes::SetItem-Methode (mfobjects.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Nicht genügend Arbeitsspeicher. |
|
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 |