IMFAttributes::GetStringLength-Methode (mfobjects.h)

  • Artikel

Ruft die Länge eines Zeichenfolgenwerts ab, der einem Schlüssel zugeordnet ist.

Syntax

HRESULT GetStringLength(
  [in]  REFGUID guidKey,
  [out] UINT32  *pcchLength
);

Parameter

[in] guidKey

GUID, die den abzurufenden Wert angibt. Der Attributtyp muss MF_ATTRIBUTE_STRING sein.

[out] pcchLength

Wenn der Schlüssel gefunden wird und der Wert ein Zeichenfolgentyp ist, empfängt dieser Parameter die Anzahl der Zeichen in der Zeichenfolge, ohne das abschließende NULL-Zeichen . Rufen Sie zum Abrufen des Zeichenfolgenwerts IMFAttributes::GetString auf.

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.
MF_E_ATTRIBUTENOTFOUND
 Der angegebene Schlüssel wurde nicht gefunden.
MF_E_INVALIDTYPE
 Der Attributwert ist keine Zeichenfolge.

Hinweise

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

MF_ATTRIBUTE_TYPE