Função ResUtilGetBinaryValue (resapi.h)

Retorna um valor binário do banco de dados de cluster.

Sintaxe

DWORD ResUtilGetBinaryValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPBYTE  *ppbOutValue,
  [out]           LPDWORD pcbOutValueSize
);

Parâmetros

[in] hkeyClusterKey

Chave no banco de dados de cluster que identifica o local do valor a ser recuperado.

[in] pszValueName

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

[out, optional] ppbOutValue

Endereço do ponteiro para o valor recuperado.

[out] pcbOutValueSize

Ponteiro para um DWORD no qual o tamanho em bytes do buffer apontado por ppbOutValue é 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	Erro ao alocar memória para o valor.

Comentários

A função de utilitário ResUtilGetBinaryValue cuida da alocação da memória necessária para o valor e, em seguida, chama a função de API de ClusterClusterRegQueryValue. Quando terminar de usar a memória alocada, 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
Biblioteca	ResUtils.lib
DLL	ResUtils.dll

Confira também

ClusterRegQueryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetMultiSzValue

ResUtilGetSzValue