CRegKey::QueryMultiStringValue

Artigo
08/25/2010

telefonar Esse método para recuperar os dados multistring para um nome de valor especificado.

LONG QueryMultiStringValue(
   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 multistring.Um multistring é uma matriz de cadeias de caracteres terminada com caractere nulo, terminadas por dois caracteres nulos.
pnChars
O dimensionar, em TCHARs do buffer apontada por pszValue. Quando o método retorna, pnChars contém o dimensionar, em TCHARs de multistring 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_MULTI_SZ, 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.