WinTrustSubjectGetCertHeader

【勇芳软件工作室】汉化HomePreviousNext

[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