CRegKey::QueryValue

Статья
06/09/2015

Этот метод вызывается для получения данных для поля указанного значения m_hKey. Более ранние версии этого метода более не поддерживаются и не помечены как 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  
);

Параметры

pszValueName
Указатель на null- завершенной строку, содержащую имя значения для запроса. Если pszValueName NULL или пустая строка (""), метод получает тип и данные для ключа безымянного или значения по умолчанию, если таковой имеется.
pdwType
Указатель на переменную, получающую код, указывающий тип данных, содержащихся в указанном диапазоне. Параметр pdwType может иметь значение NULL, если тип кодирует не требуется.
pData
Указатель на буфер, получающий данные значения. Этот параметр может иметь значение NULL, если данные не требуется.
pnBytes
Указатель на переменную, которая определяет размер буфера в байтах pData указал значение параметра. После возврата из этого метода, эта переменная содержит размер данных, копируемых в pData.
dwValue
Числовые данные поля значение.
lpszValueName
Определяет поле значения для запроса.
szValue
Строковые данные поля значение.
pdwCount
Размер данных в строке. Его значение установлено равным размеру буфера исходной szValue.

Возвращаемое значение

Если успешно, передачи ERROR_SUCCESS; в противном случае – значение ненулевой код ошибки, заданный в атрибуте WINERROR.H.

Заметки

2 Исходной версии QueryValue больше не поддерживаются и не помечены как ATL_DEPRECATED. Компилятор выводит предупреждение, если эти формы используются.

Остальные вызовы методов RegQueryValueEx.

Примечание по безопасности
Этот метод позволяет вызывающему объекту задать любое расположение в реестре, потенциально при считывании данных, которые нельзя доверять.Также используется функция RegQueryValueEx этим методом, которые явно не обрабатывает строки NULL завершения.Оба условия должны иметь проверены для вызывающего кода.

Этот метод позволяет вызывающему объекту задать любое расположение в реестре, потенциально при считывании данных, которые нельзя доверять.Также используется функция RegQueryValueEx этим методом, которые явно не обрабатывает строки NULL завершения.Оба условия должны иметь проверены для вызывающего кода.

Требования

Header: atlbase.h

См. также

Ссылки

CRegKey Class

CRegKey::SetValue

Registry Value Types

Поделиться через