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 recurso es mayor que el número de caracteres especificado, se trunca y finaliza en null.

Nota:

Este parámetro puede no establecerse en cero.

Valor devuelto

Tipo: HRESULT

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

Requisitos

Consulte también

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree