[New - Windows NT]
WinTrustSubjectGetCertHeader功能从指定的主题中检索WIN_CERTIFICATE结构的标头部分。来电者指定要检索的证书的类型。返回的信息不包括WIN_CERTIFICATE结构的bCertificate成员中的数据。
BOOL WinTrustSubjectGetCertHeader(
LPWIN_TRUST_SIP_SUBJECT 【lpSubject】, | //指向主题描述的指针 |
DWORD 【dwCertificateIndex】, | //要检索的证书类型 |
LPWIN_CERTIFICATE 【lpCertificateHeader】 | //指向接收证书头的缓冲区的指针 |
); |
参数
【lpSubject】
指向WIN_TRUST_SIP_SUBJECT结构的指针,用于标识从中获取证书头的主题。
【dwCertificateIndex】
指定要检索的证书的类型。您可以调用WinTrustSubjectEnumCertificates函数来枚举主题包含的证书类型。
【lpCertificateHeader】
指向接收证书头的WIN_CERTIFICATE结构的指针。
返回值
如果函数成功,则返回值为非零值。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
信任提供者调用WinTrustSubjectGetCertHeader函数的WinTrust实现。WinTrust然后调用WinTrustSubjectGetCertHeader相应的主题界面包(SIP)的实现。适当的SIP是用于处理由【lpSubject】参数指定的主题类型的SIP。
每个主题界面包(SIP)DLL都必须实现WinTrustSubjectGetCertHeader功能。当WinTrust调用SIP的WinTrustSipInitialize初始化功能时,WinTrust将获得指向SIP的WinTrustSubjectGetCertHeader实现的指针。
LPWINTRUST_SUBJECT_GET_CERT_HEADER类型是指向WinTrustSubjectGetCertHeader函数的指针。
也可以看看
WIN_CERTIFICATE, WIN_TRUST_SIP_SUBJECT, WinTrustSipInitialize, WinTrustSubjectEnumCertificates