Compartilhar via


Função ResUtilGetMultiSzValue (resapi.h)

Retorna um valor de cadeia de caracteres múltipla do banco de dados do cluster.

Sintaxe

DWORD WINAPI_INLINE ResUtilGetMultiSzValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPWSTR  *ppszOutValue,
  [out]           LPDWORD pcbOutValueSize
);

Parâmetros

[in] hkeyClusterKey

Chave que identifica o local do valor de cadeia de caracteres múltipla no banco de dados do cluster.

[in] pszValueName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do valor a ser recuperado.

[out, optional] ppszOutValue

Endereço do ponteiro para o valor recuperado.

[out] pcbOutValueSize

Ponteiro para um DWORD no qual o tamanho em bytes do buffer apontado por ppszOutValue é retornado.

Retornar valor

Se as operações forem bem-sucedidas, a função retornará ERROR_SUCCESS.

Se a operação falhar, a função retornará um código de erro do sistema. Veja a seguir um possível código de erro.

Código de retorno Descrição
ERROR_NOT_ENOUGH_MEMORY
Ocorreu um erro durante a alocação de memória.

Comentários

Quando terminar de usar a memória alocada para o valor retornado pela função de utilitário ResUtilGetMultiSzValue , você deverá chamar a função LocalFree para liberá-la.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de Destino Windows
Cabeçalho resapi.h

Confira também

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetSzValue