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 参数。 此值可以是以下值:
值 | 含义 |
---|---|
|
ppvInfo 参数返回描述符规则字符串。 |
[out] ppvInfo
指向描述符信息的指针。
返回值
返回指示函数成功或失败的状态代码。 可能的返回代码包括但不限于以下内容。
返回代码 | 说明 |
---|---|
|
函数成功。 |
|
ppvInfo 参数不能为 NULL。 |
|
dwInfoType 参数中指定了不受支持的值。 |
|
hDescriptor 参数指定的句柄无效。 |
要求
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | ncryptprotect.h |
Library | NCrypt.lib |
DLL | NCrypt.dll |