[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