Método IMFAttributes::GetAllocatedString (mfobjects.h)

  • Artículo

Obtiene una cadena de caracteres anchos asociada a una clave. Este método asigna la memoria de la cadena.

Sintaxis

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

Parámetros

[in] guidKey

GUID que identifica qué valor se va a recuperar. El tipo de atributo debe ser MF_ATTRIBUTE_STRING.

[out] ppwszValue

Si se encuentra la clave y el valor es un tipo de cadena, este parámetro recibe una copia de la cadena. El autor de la llamada debe liberar la memoria de la cadena llamando a CoTaskMemFree.

[out] pcchLength

Recibe el número de caracteres de la cadena, excepto el carácter NULL de terminación. Este parámetro no debe ser NULL.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_ATTRIBUTENOTFOUND
 No se encontró la clave especificada.
MF_E_INVALIDTYPE
 El valor del atributo no es una cadena.

Comentarios

Para copiar un valor de cadena en un búfer asignado por el autor de la llamada, use el método IMFAttributes::GetString .

Esta interfaz está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

  • Windows XP con Service Pack 2 (SP2) y versiones posteriores.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalados.
Nota Una versión anterior de la documentación indicó incorrectamente que el parámetro pcchLength puede ser NULL. Establecer este parámetro en NULL puede tener éxito en algunos casos, pero no se garantiza. El llamador debe pasar un puntero distinto de NULL para este parámetro.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfobjects.h (include Mfidl.h)
Library Mfuuid.lib

Consulte también

Atributos y propiedades

IMFAttributes

MF_ATTRIBUTE_TYPE