IMFAttributes::GetAllocatedString-Methode (mfobjects.h)

  • Artikel

Ruft eine Breitzeichenzeichenfolge ab, die einem Schlüssel zugeordnet ist. Diese Methode weist den Arbeitsspeicher für die Zeichenfolge zu.

Syntax

HRESULT GetAllocatedString(
  [in]  REFGUID guidKey,
  [out] LPWSTR  *ppwszValue,
  [out] UINT32  *pcchLength
);

Parameter

[in] guidKey

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

[out] ppwszValue

Wenn der Schlüssel gefunden wird und der Wert ein Zeichenfolgentyp ist, empfängt dieser Parameter eine Kopie der Zeichenfolge. Der Aufrufer muss den Speicher für die Zeichenfolge durch Aufrufen von CoTaskMemFree freigeben.

[out] pcchLength

Empfängt die Anzahl der Zeichen in der Zeichenfolge, ausgenommen das beendende NULL-Zeichen . Dieser Parameter darf nicht NULL 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.
MF_E_ATTRIBUTENOTFOUND
 Der angegebene Schlüssel wurde nicht gefunden.
MF_E_INVALIDTYPE
 Der Attributwert ist keine Zeichenfolge.

Hinweise

Um einen Zeichenfolgenwert in einen vom Aufrufer zugewiesenen Puffer zu kopieren, verwenden Sie die IMFAttributes::GetString-Methode .

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.
Hinweis In einer früheren Version der Dokumentation wurde fälschlicherweise angegeben, dass der pcchLength-ParameterNULL sein kann. Das Festlegen dieses Parameters auf NULL kann in einigen Fällen erfolgreich sein, ist aber nicht garantiert. Der Aufrufer muss einen Nicht-NULL-Zeiger für diesen Parameter übergeben.
 

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