Función UtilLoadStringWithAlloc

La función UtilLoadStringWithAlloc asigna y carga una cadena fuera de la tabla de recursos.

Sintaxis

HRESULT UtilLoadStringWithAlloc(
  _In_  UINT   uID,
  _Out_ LPWSTR *ppwzBuffer,
  _In_  UINT   cchBufferMax
);

Parámetros

uID [in]

Tipo: UINT

Identificador de la cadena que se va a cargar.

ppwzBuffer [out]

Tipo: LPWSTR*

Ubicación donde se colocará la cadena recién asignada. La cadena debe liberarse con CoTaskMemFree cuando ya no sea necesario.

cchBufferMax [in]

Tipo: UINT

Número máximo de caracteres que se van a cargar desde la tabla de recursos. Si la cadena de recursos es mayor que el número de caracteres especificado, se trunca y termina en null.

Nota

Este parámetro no se puede establecer en cero.

Valor devuelto

Tipo: HRESULT

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_INVALIDARG	Uno o varios parámetros no se han proporcionado correctamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado	Ndattributils.h

Vea también

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree