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


CRegKey::QueryBinaryValue

Этот метод вызывается для получения двоичных данных для имени указанного значения.

LONG QueryBinaryValue( 
   LPCTSTR pszValueName, 
   void* pValue, 
   ULONG* pnBytes  
) throw( );

Параметры

  • pszValueName
    Указатель на null- завершенной строку, содержащую имя значения для запроса.

  • pValue
    Указатель на буфер, получающий данные значения.

  • pnBytes
    Указатель на переменную, которая определяет размер буфера в байтах pValue указал значение параметра. После возврата из этого метода, эта переменная содержит размер данных, копируемых в буфер.

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

Если метод завершается успешно, возвращается значение ERROR_SUCCESS. Если метод не удается прочитать значение, то оно возвратит ненулевой код ошибки, заданный в атрибуте WINERROR.H. Если ссылочные данные не является типом REG_BINARY, то возвращается ERROR_INVALID_DATA.

Заметки

Этот метод использует RegQueryValueEx и подтверждает, что возвращается правильный тип данных. Дополнительные сведения см. в разделе RegQueryValueEx.

Примечание о безопасностиПримечание по безопасности

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

См. также

Ссылки

CRegKey Class

CRegKey::SetBinaryValue

CRegKey::QueryDWORDValue

CRegKey::QueryGUIDValue

CRegKey::QueryMultiStringValue

CRegKey::QueryQWORDValue

CRegKey::QueryStringValue