CRegKey::QueryBinaryValue

Artigo
08/25/2010

Chame esse método para recuperar os dados binário para um nome de valor especificado.

LONG QueryBinaryValue(
   LPCTSTR pszValueName,
   void* pValue,
   ULONG* pnBytes 
) throw( );

Parâmetros

pszValueName
Ponteiro para uma cadeia terminada com nulo que contém o nome do valor a consulta.
pValue
Ponteiro para um buffer que receberá os dados do valor.
pnBytes
Ponteiro para uma variável que especifica o dimensionar em bytes, do buffer apontado pelo pValue parâmetro. Quando o método retorna, essa variável contém o dimensionar dos dados copiados para o buffer.

Valor de retorno

Se o método for bem-sucedido, será retornado ERROR_SUCCESS.Se o método não conseguir ler um valor, ele retorna um código de erro diferente de zero definido no Winerror.H.Se os dados referenciados não são do tipo REG_BINARY, ERROR_INVALID_DATA será retornado.

Comentários

Esse método faz uso de RegQueryValueEx e confirma que o tipo de dados correto é retornado.See RegQueryValueEx para obter mais detalhes.

Observação de segurança:
Esse método permite que o chamador especificar qualquer local do registro, potencialmente leitura de dados que não podem ser confiáveis.Além disso, o RegQueryValueEx função usada por este método não manipula explicitamente strings que são nulo terminada.As duas condições devem ser verificadas quanto pelo código de chamada.