Função UtilLoadStringWithAlloc

A função UtilLoadStringWithAlloc aloca e carrega uma cadeia de caracteres para fora da tabela de recursos.

Sintaxe

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

Parâmetros

uID [em]

Tipo: UINT

Identificador da cadeia de caracteres a ser carregada.

ppwzBuffer [saída]

Tipo: LPWSTR*

O local onde a cadeia de caracteres recém-alocada será colocada. A cadeia de caracteres deve ser liberada usando CoTaskMemFree quando não for mais necessária.

cchBufferMax [em]

Tipo: UINT

O número máximo de caracteres a serem carregados da tabela de recursos. Se a cadeia de caracteres de recurso for maior do que o número de caracteres especificados, ela será truncada e terminada em nulo.

Observação

Este parâmetro não pode ser definido como zero.

Valor de retorno

Tipo: HRESULT

Os valores de retorno possíveis incluem, mas não estão limitados a, o seguinte.

Requerimentos

Ver também

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree