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