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

Открывает подраздел реестра в пользовательском поддереве (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 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlwapi.h
Библиотека	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)