Функция RegOpenCurrentUser (winreg.h)

  • Статья

Извлекает дескриптор ключа HKEY_CURRENT_USER для пользователя, олицетворяемого текущим потоком.

Синтаксис

LSTATUS RegOpenCurrentUser(
  [in]  REGSAM samDesired,
  [out] PHKEY  phkResult
);

Параметры

[in] samDesired

Маска, указывающая требуемые права доступа к ключу. Функция завершается ошибкой, если дескриптор безопасности ключа не разрешает запрошенный доступ для вызывающего процесса. Дополнительные сведения см. в разделе Безопасность раздела реестра и права доступа.

[out] phkResult

Указатель на переменную, которая получает дескриптор открытого ключа. Если возвращенный дескриптор больше не нужен, вызовите функцию RegCloseKey , чтобы закрыть его.

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

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой ненулевой код ошибки, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.

Комментарии

Ключ HKEY_CURRENT_USER сопоставляется с корнем ветви текущего пользователя в HKEY_USERS ключе. Он кэшируется для всех потоков в процессе. Поэтому это значение не изменяется при загрузке профиля другого пользователя. RegOpenCurrentUser использует маркер потока для доступа к соответствующему ключу или значение по умолчанию, если профиль не загружен.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winreg.h (включая Windows.h)
Библиотека Advapi32.lib
DLL Advapi32.dll

См. также раздел

RegCloseKey

Функции реестра

Общие сведения о реестре