CRegKey::QueryStringValue

Artigo
08/25/2010

telefonar Esse método para recuperar os dados de seqüência de caracteres para um nome de valor especificado.

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

Parâmetros

pszValueName
Ponteiro para uma cadeia terminada com nulo que contém o nome do valor a consulta.
pszValue
Ponteiro para um buffer que recebe os dados de seqüência de caracteres.
pnChars
O dimensionar, em TCHARs do buffer apontada por pszValue. Quando o método retorna, pnChars contém o dimensionar, em TCHARs da seqüência de caracteres recuperados, incluindo um caractere nulo de terminação.

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_SZ, ERROR_INVALID_DATA será retornado.Se o método retornar ERROR_MORE_DATA, pnChars é igual a zero, não o dimensionar do buffer necessário em bytes.

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, th e 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.