Метод IMFAttributes::GetAllocatedString (mfobjects.h)

Возвращает строку расширенных символов, связанную с ключом. Этот метод выделяет память для строки.

Синтаксис

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

Параметры

[in] guidKey

Идентификатор GUID, определяющий, какое значение следует извлечь. Тип атрибута должен быть MF_ATTRIBUTE_STRING.

[out] ppwszValue

Если ключ найден, а значение является строковым типом, этот параметр получает копию строки. Вызывающий объект должен освободить память для строки, вызвав CoTaskMemFree.

[out] pcchLength

Получает количество символов в строке, за исключением завершающего символа NULL . Этот параметр не должен иметь значение NULL.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
MF_E_ATTRIBUTENOTFOUND	Указанный ключ не найден.
MF_E_INVALIDTYPE	Значение атрибута не является строкой.

Комментарии

Чтобы скопировать строковое значение в буфер, выделенный вызывающим объектом, используйте метод IMFAttributes::GetString .

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK для Windows Media Format 11:

• Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
• Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления за октябрь 2006 г. для Windows XP Media Center Edition).

Примечание В более ранней версии документации неправильно указывалось, что параметр pcchLength может иметь значение NULL. Установка для этого параметра значения NULL в некоторых случаях может быть выполнена успешно, но это не гарантируется. Вызывающий объект должен передать для этого параметра указатель, отличный от NULL .

 

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	mfobjects.h (включая Mfidl.h)
Библиотека	Mfuuid.lib

См. также раздел

Атрибуты и свойства

IMFAttributes

MF_ATTRIBUTE_TYPE