CRegKey::QueryValue

Artigo
02/25/2013

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.