Função UtilLoadStringWithAlloc

Artigo
06/13/2023

A função UtilLoadStringWithAlloc aloca e carrega uma cadeia de caracteres 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 em que 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 [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 retornado

Tipo: HRESULT

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

Código de retorno	Descrição
S_OK	A operação foi realizada com êxito.
E_INVALIDARG	Um ou mais parâmetros não foram fornecidos corretamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho	Ndattributils.h

Confira também

UtilStringCopyWithAlloc
UtilAssembleStringsWithAlloc
Cotaskmemfree

Compartilhar via