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

Статья
03/15/2023

Функция NCryptGetProtectionDescriptorInfo извлекает строку правила дескриптора защиты.

Синтаксис

SECURITY_STATUS NCryptGetProtectionDescriptorInfo(
  [in]           NCRYPT_DESCRIPTOR_HANDLE hDescriptor,
  [in, optional] const NCRYPT_ALLOC_PARA  *pMemPara,
                 DWORD                    dwInfoType,
  [out]          void                     **ppvInfo
);

Параметры

[in] hDescriptor

Дескриптор защиты, созданный путем вызова NCryptCreateProtectionDescriptor.

[in, optional] pMemPara

Указатель на структуру NCRYPT_ALLOC_PARA , которую можно использовать для указания пользовательских функций управления памятью. Если для этого аргумента задано значение NULL, функция LocalAlloc используется для внутреннего выделения памяти, и приложение должно вызвать LocalFree , чтобы освободить память, на которую указывает параметр ppvInfo .

dwInfoType

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

Значение	Значение
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING	Аргумент ppvInfo возвращает строку правила дескриптора.

[out] ppvInfo

Указатель на сведения дескриптора.

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

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

Код возврата	Описание
ERROR_SUCCESS	Функция выполнена успешно.
NTE_INVALID_PARAMETER	Параметр ppvInfo не может иметь значение NULL.
NTE_NOT_SUPPORTED	Неподдерживаемое значение указано в параметре dwInfoType .
NTE_INVALID_HANDLE	Дескриптор, указанный параметром hDescriptor , недопустим.

Требования


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

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

Функции DPAPI CNG

NCryptCreateProtectionDescriptor

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