使用密钥存储提供程序(KSP)的 NCryptEnumKeys - AWS CloudHSM

使用密钥存储提供程序(KSP)的 NCryptEnumKeys

NCryptEnumKeys 函数列出了存储在密钥存储提供程序(KSP)中的密钥。

参数

hProvider [in]

密钥存储提供程序句柄。使用 NCryptOpenStorageProvider 获取此句柄。

pszScope [in, unused]

将此参数设置为 NULL。

ppKeyName [out]

指向存储密钥名称的 NCryptKeyName 结构的指针地址。要在使用后释放内存,请调用 NCryptFreeBuffer

ppEnumState [in, out]

用于跟踪枚举进度的 VOID 指针地址。密钥存储提供程序在内部使用此信息来管理枚举序列。要从头开始新的枚举,请将此指针设置为 NULL。

要在完成枚举后释放此内存,请将此指针传递给 NCryptFreeBuffer

dwFlags [in]

用于修改函数行为的标志。此函数没有标志。

返回值

该函数返回一个状态代码,指示成功或失败。

常见的返回代码包括:

返回代码 描述

ERROR_SUCCESS

操作已成功完成。

NTE_INVALID_PARAMETER

一个或多个参数无效。

NTE_FAIL

操作无法完成。

NTE_INVALID_HANDLE

hProvider 中的句柄无效。

NTE_NO_MORE_ITEMS

枚举列出了所有可用的密钥。