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

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

  • Статья

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