CRegKey::QueryValue

Artigo
06/09/2015

Chamar esse método para recuperar os dados para o campo de valor especificado de m_hKey. As versões anteriores de este método não são suportadas e marcadas como ATL_DEPRECATED.

LONG QueryValue( 
   LPCTSTR pszValueName, 
   DWORD* pdwType, 
   void* pData, 
   ULONG* pnBytes 
) throw( ); 
ATL_DEPRECATED LONG QueryValue( 
   DWORD& dwValue, 
   LPCTSTR lpszValueName  
); 
ATL_DEPRECATED LONG QueryValue( 
   LPTSTR szValue, 
   LPCTSTR lpszValueName, 
   DWORD* pdwCount  
);

Parâmetros

pszValueName
Ponteiro para uma cadeia de caracteres NULL- finalizada que contém o nome do valor para consulte. Se pszValueName é NULL ou uma cadeia de caracteres vazia, "", o método retorna o tipo e os dados para a chave sem nome ou o valor padrão, se houver.
pdwType
Um ponteiro a variável que recebe um código que indica o tipo de dados armazenados no valor especificado. O parâmetro de pdwType pode ser NULL se o código de tipo não é necessário.
pData
Ponteiro para um buffer que receberá os dados do valor. Este parâmetro pode ser NULL se os dados não são necessários.
pnBytes
O ponteiro para uma variável que especifica o tamanho, em bytes, de buffer apontou a pData pelo parâmetro. Quando o método retorna, essa variável contém o tamanho dos dados copiados para o pData.
dwValue
Os dados numéricos de campo de valor.
lpszValueName
Especifica o campo de valor a ser consultado.
szValue
Os dados da cadeia de caracteres de campo de valor.
pdwCount
O tamanho dos dados da cadeia de caracteres. O valor é definido inicialmente o tamanho do buffer de szValue .

Valor de retorno

Se com êxito, retorna ERROR_SUCCESS; caso contrário, um código de erro diferente de zero definido em. WINERROR.H.

Comentários

As duas versões originais de QueryValue não são suportadas e marcadas como ATL_DEPRECATED. O compilador emitirá um aviso se esses formulários são usados.

O método chama RegQueryValueEx restante.

Observação de segurança
Esse método permite que o chamador especificar qualquer local de Registro, potencialmente ler os dados que não podem ser confiáveis.Além de isso, a função de RegQueryValueEx usada por esse método não trata explicitamente as cadeias de caracteres que são NULL finalizaram.Ambas as condições devem ser marcadas para o código de chamada.