Функция 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.

Комментарии

Требования