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

Функция NCryptRegisterProtectionDescriptorName (ncryptprotect.h)

  • Статья

Функция NCryptRegisterProtectionDescriptorName регистрирует отображаемое имя и связанную строку правила для дескриптора защиты.

Синтаксис

SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
  [in]           LPCWSTR pwszName,
  [in, optional] LPCWSTR pwszDescriptorString,
                 DWORD   dwFlags
);

Параметры

[in] pwszName

Указатель на строку Юникода, завершающуюся null, которая содержит отображаемое имя регистрируемых дескрипторов.

[in, optional] pwszDescriptorString

Указатель на строку Юникода, завершающуюся null, которая содержит правило дескриптора защиты. Если этот параметр имеет значение NULL или строка пуста, значение реестра, созданное ранее для параметра pwszName , будет удалено.

dwFlags

Константа, указывающая куст реестра, в котором регистрируется новая запись. Если это значение равно нулю (0), корневой каталог реестра HKEY_CURRENT_USER. Если это значение равно NCRYPT_MACHINE_KEY_FLAG, корневой элемент будет HKEY_LOCAL_MACHINE.

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

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

Код возврата Описание
ERROR_SUCCESS
 Функция выполнена успешно.
NTE_INVALID_PARAMETER
 Параметр pwszName не может иметь значение NULL, а значение, на которое указывает параметр, не может быть пустой строкой.
NTE_BAD_FLAGS
 Параметр dwFlags должен быть равен нулю или NCRYPT_MACHINE_KEY_FLAG.

Комментарии

Раздел реестра, созданный с помощью этой функции, не является непостоянным. Эти сведения хранятся в файле и сохраняются при завершении работы компьютера.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header ncryptprotect.h
Библиотека NCrypt.lib
DLL NCrypt.dll

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

Функции DPAPI CNG

NCryptQueryProtectionDescriptorName