Функция 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.
Возвращаемое значение
Возвращает код состояния, указывающий на успешное или неудачное выполнение функции. Возможные коды возврата включают, помимо прочего, следующие.
Код возврата | Описание |
---|---|
|
Функция выполнена успешно. |
|
Параметр pwszName не может иметь значение NULL, а значение, на которое указывает параметр, не может быть пустой строкой. |
|
Параметр dwFlags должен быть равен нулю или NCRYPT_MACHINE_KEY_FLAG. |
Комментарии
Раздел реестра, созданный с помощью этой функции, не является непостоянным. Эти сведения хранятся в файле и сохраняются при завершении работы компьютера.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 8 [только классические приложения] |
Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
Целевая платформа | Windows |
Header | ncryptprotect.h |
Библиотека | NCrypt.lib |
DLL | NCrypt.dll |