Функция SHRegOpenUSKeyA (shlwapi.h)

Статья
11/20/2024

Открывает подраздел реестра в поддереве конкретного пользователя (HKEY_CURRENT_USER или HKEY_LOCAL_MACHINE).

Синтаксис

LSTATUS SHRegOpenUSKeyA(
  [in]           LPCSTR  pszPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           BOOL    fIgnoreHKCU
);

Параметры

[in] pszPath

Тип: LPCTSTR

Указатель на строку, завершаемую значением NULL, с именем подраздела.

[in] samDesired

Тип: REGSAM

Требуемый доступ к безопасности. Дополнительные сведения о доступе к безопасности см. в REGSAM.

[in, optional] hRelativeUSKey

Тип: HUSKEY

Ключ, используемый в качестве основы для относительных путей. Если pszPath является относительным путем, ключ, который он указывает, будет относительно hRelativeUSKey. Если pszPath является абсолютным путем, задайте hRelativeUSKey значение NULL.

[out] phNewUSKey

Тип: PHUSKEY

Указатель на дескриптор открытого ключа.

[in] fIgnoreHKCU

Тип: BOOL

Переменная, указывающая, какой ключ следует просмотреть. Если задано значение TRUE, SHRegOpenUSKey игнорирует HKEY_CURRENT_USER и возвращает значение из HKEY_LOCAL_MACHINE.

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

Тип: LSTATUS

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

Замечания

Заметка

Заголовок shlwapi.h определяет SHRegOpenUSKey как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)

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