NCryptGetProtectionDescriptorInfo 函数 (ncryptprotect.h)

  • 项目

NCryptGetProtectionDescriptorInfo 函数检索保护描述符规则字符串。

语法

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

parameters

[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
标头 ncryptprotect.h
Library NCrypt.lib
DLL NCrypt.dll

请参阅

CNG DPAPI 函数

NCryptCreateProtectionDescriptor