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。可能的值包括（但并不限于）下表中的项。

若要将字符串值复制到调用方分配的缓冲区中，请使用 IMFAttributes：：GetString 方法。

如果安装了 Windows Media Format 11 SDK 可再发行组件，则此接口在以下平台上可用：

Windows XP with Service Pack 2 (SP2) 及更高版本。
Windows XP Media Center Edition 2005 KB900325 (windows XP Media Center Edition 2005) 和KB925766 (2006 年 10 月 Windows XP Media Center Edition 更新汇总) 安装。

注意早期版本的文档错误地指出 pcchLength 参数可以为 NULL。在某些情况下，将此参数设置为 NULL 可能会成功，但不能保证。调用方必须为此参数传递非 NULL 指针。