Compartir a través de

Función UtilLoadStringWithAlloc

  • Artículo

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