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 [in]

Tipo: UINT

Identificador da cadeia de caracteres a ser carregada.

ppwzBuffer [out]

Tipo: LPWSTR*

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

cchBufferMax [in]

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 que o número de caracteres especificado, ela será truncada e terminada em nulo.

Observação

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

Valor de retorno

Tipo: HRESULT

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

Requisitos

Consulte também

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree