Compartilhar via


CRegKey::QueryMultiStringValue

Chamar esse método para recuperar os dados multistring para um nome especificado de valor.

LONG QueryMultiStringValue(
   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 multistring.Multistring é uma matriz de cadeias de caracteres NULL- terminadas, finalizada por dois caracteres nulos.

  • pnChars
    O tamanho, em, TCHARs de buffer apontado por pszValue.Quando o método retorna, pnChars contém o tamanho, em TCHARs, de multistring recuperado, 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_MULTI_SZ, ERROR_INVALID_DATA será retornado.

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çaObservaçã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.

Requisitos

Cabeçalho: atlbase.h

Consulte também

Referência

Classe de CRegKey

CRegKey::SetMultiStringValue

CRegKey::QueryBinaryValue

CRegKey::QueryDWORDValue

CRegKey::QueryGUIDValue

CRegKey::QueryQWORDValue

CRegKey::QueryStringValue