CRegKey::QueryStringValue

Artigo
02/25/2013

Chamar esse método para recuperar dados da cadeia de caracteres para um nome especificado de valor.

LONG QueryStringValue(
   LPCTSTR pszValueName,
   LPTSTR pszValue,
   ULONG* pnChars 
) throw( );

Parâmetros

pszValueName
Ponteiro para uma cadeia de caracteres NULL- finalizada que contém o nome do valor para consulte.
pszValue
Ponteiro para um buffer que receberá os dados de cadeia de caracteres.
pnChars
O tamanho, em, TCHARs de buffer apontado por pszValue.Quando o método retorna, pnChars contém o tamanho, em, TCHARs de cadeia de caracteres recuperada, incluindo um caractere de terminação zero.

Valor de retorno

Se o método ERROR_SUCCESS tiver êxito, será retornado.Se o método não ler um valor, retorna um código de erro diferente de zero definido em. WINERROR.H.Se os dados referenciados não são do tipo REG_SZ, ERROR_INVALID_DATA será retornado.Se o método retorna ERROR_MORE_DATA, pnChars é igual a zero, não o tamanho do buffer necessário em bytes.

Comentários

Este método utiliza RegQueryValueEx e confirme que o tipo correto de dados será retornado.Consulte RegQueryValueEx para obter mais detalhes.

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 terminadas NULAS.Ambas as condições devem ser marcadas para o código de chamada.