[Now Supported on Windows NT]
ImageEnumerateCertificates功能用于返回有关当前包含在图像文件中的证书的信息。
BOOL ImageEnumerateCertificates(
| IN HANDLE【FileHandle】, | |
| IN DWORD【TypeFilter】, | |
| OUT PDWORD【CertificateCount】, | |
| IN OUT PDWORD【指数】OPTIONAL, | |
| IN OUT DWORD【IndexCount】OPTIONAL | |
| ); |
参数
【FileHandle】
这将为要检查的图像文件提供句柄。必须为FILE_READ_DATA访问才能打开该句柄。
【TypeFilter】
这提供了DICE证书部分类型，以在返回证书信息时用作过滤器。应传递DICE_SECTION_TYPE_ANY以获取图像中存在的所有部分类型的信息。
【CertificateCount】
这里填写了包含【TypeFilter】参数指定类型的图像的证书数量。如果没有找到，该参数将返回零。
【指数】
这可选地提供一个缓冲区用于将索引数组返回到包含指定类型的部分的证书。对于索引值不应该采用排序，也不会在查询DICE_SECTION_TYPE_ANY时保证是连续的。
【IndexCount】
这将提供【指数】缓冲区的DWORD中的长度。每当存在【指数】时，将检查此参数。如果【CertificateCount】大于【IndexCount】，【指数】将填写图像中第一个【IndexCount】部分，并返回相应的警告。
返回值
如果函数成功，返回值为TRUE。
如果函数失败，则返回值为FALSE。要检索扩展错误信息，请调用GetLastError.
备注
ImageEnumerateCertificates函数返回有关当前包含在图像文件中的证书的信息。它具有过滤功能，允许返回包含任何单一类型（或任何类型）的部分的证书。
一旦找到了有趣的证书的索引，就可以将它们传递给ImageGetCertificateData以获取证书的实体。
Windows NT：此函数在Windows NT 3.51下不可用;它是在Windows NT 4.0中引入的。
