CertGetValidUsages 函数 (wincrypt.h)
CertGetValidUsages 函数返回一个用法数组,该数组由证书数组中所有证书的有效用法的交集组成。
语法
BOOL CertGetValidUsages(
[in] DWORD cCerts,
[in] PCCERT_CONTEXT *rghCerts,
[out] int *cNumOIDs,
[out] LPSTR *rghOIDs,
[in, out] DWORD *pcbOIDs
);
参数
[in] cCerts
要检查的数组中的证书数。
[in] rghCerts
要检查是否有效使用的证书数组。
[out] cNumOIDs
作为数组中所有证书的有效用法的交集找到的有效用法数。 如果所有证书对所有用法都有效,则 cNumOIDs 将设置为负 1 (-1) 。
[out] rghOIDs
对象 标识符 的数组 (OID) rghCerts 数组中的所有证书共享的有效用法。 此参数可以为 NULL ,用于设置此结构的大小,以便进行内存分配。 有关详细信息,请参阅 检索未知长度的数据。
[in, out] pcbOIDs
指向 DWORD 值的指针,该值指定 rghOID 数组 和指向的字符串的大小(以字节为单位)。 当函数返回时, DWORD 值包含数组所需的字节数。
返回值
如果该函数成功,则返回值为非零值。 如果函数失败,则返回值为零。 有关扩展的错误信息,请调用 GetLastError。
要求
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | wincrypt.h |
Library | Crypt32.lib |
DLL | Crypt32.dll |