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

Создает или открывает подраздел реестра в пользовательском поддереве (HKEY_CURRENT_USER или HKEY_LOCAL_MACHINE).

Синтаксис

LSTATUS SHRegCreateUSKeyW(
                 LPCWSTR pwzPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           DWORD   dwFlags
);

Параметры

pwzPath

TBD

[in] samDesired

Тип: REGSAM

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

[in, optional] hRelativeUSKey

Тип: HUSKEY

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

[out] phNewUSKey

Тип: PHUSKEY

Указатель на КЛЮЧ HUSKEY , который получит дескриптор нового ключа.

[in] dwFlags

Тип: DWORD

Базовый ключ, под которым должен быть открыт ключ. Это может быть одно или несколько из следующих значений.

SHREGSET_HKCU

Создайте или откройте ключ в разделе HKEY_CURRENT_USER. Создает ключ, только если он пуст.

SHREGSET_FORCE_HKCU

Создайте или откройте ключ в разделе HKEY_CURRENT_USER. Создает ключ, даже если он не пуст.

SHREGSET_HKLM

Создайте или откройте ключ в разделе HKEY_LOCAL_MACHINE. Создает ключ, только если он пуст.

SHREGSET_FORCE_HKLM

Создайте или откройте ключ в разделе HKEY_LOCAL_MACHINE. Создает ключ, даже если он не пуст.

SHREGSET_DEFAULT

Создайте или откройте ключ в HKEY_CURRENT_USER (принудительно) и HKEY_LOCAL_MACHINE (только в том случае, если он пуст). Этот флаг эквивалентен (SHREGSET_FORCE_HKCU | SHREGSET_HKLM).

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

Тип: LSTATUS

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

Комментарии

Если вы хотите записать значения в новый ключ, используйте SHRegWriteUSValue для записи каждого значения, передав дескриптор HUSKEY , возвращаемый через phNewUSKey. По завершении закройте раздел реестра для конкретного пользователя с помощью SHRegCloseUSKey.

Требования