WinTrustSubjectGetCertificate

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

[New - Windows NT]

WinTrustSubjectGetCertificate功能从主题中检索指定的证书。

BOOL WinTrustSubjectGetCertificate(

LPWIN_TRUST_SIP_SUBJECT 【lpSubject】,//指向主题描述的指针
DWORD 【dwCertificateIndex】,//要检索的证书类型
LPWIN_CERTIFICATE 【lpCertificate】,//指向接收证书的缓冲区的指针
LPDWORD 【lpRequiredLength】//指向缓冲区的大小(以字节为单位)的指针
); 

参数

【lpSubject】

指向WIN_TRUST_SIP_SUBJECT结构的指针,用于标识从中获取证书的主题。

【dwCertificateIndex】

指定要检索的证书的类型。您可以调用WinTrustSubjectEnumCertificates函数来枚举主题包含的证书类型。

【lpCertificate】

指向缓冲区的指针,它接收WIN_CERTIFICATE结构头和关联的证书数据。

【lpRequiredLength】

指向DWORD.在输入时,它指定【lpCertificate】缓冲区的大小(以字节为单位)。在输出时,它会收到返回证书的长度。如果缓冲区不够大以容纳证书,该函数将失败,【lpRequiredLength】返回所需的缓冲区大小。

返回值

如果函数成功,则返回值为非零值。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

信任提供者调用了WinTrustSubjectGetCertificate函数的WinTrust实现。WinTrust然后调用WinTrustSubjectGetCertificate相应主题界面包(SIP)的实现。适当的SIP是用于处理由【lpSubject】参数指定的主题类型的SIP。

每个主题界面包(SIP)DLL都必须实现WinTrustSubjectGetCertificate功能。当WinTrust调用SIP的WinTrustSipInitialize初始化功能时,WinTrust将获得指向SIP的WinTrustSubjectGetCertificate实现的指针。

LPWINTRUST_SUBJECT_GET_CERTIFICATE类型是指向WinTrustSubjectGetCertificate函数的指针。

也可以看看

WIN_CERTIFICATE, WIN_TRUST_SIP_SUBJECT, WinTrustSipInitialize, WinTrustSubjectEnumCertificates