ISCrdEnr::getSigningCertificateName 方法
getSigningCertificateName 方法从签名证书中检索使用者名称。
此方法还可用于在对话框中显示证书。 此方法调用 CryptoAPI 函数 CertGetNameString。
语法
HRESULT getSigningCertificateName(
[in] DWORD dwFlags,
[out] BSTR *pbstrSigningCertName
);
SCrdEnr.getSigningCertificateName( _
ByVal dwFlags, _
ByRef pbstrSigningCertName _
)
参数
-
dwFlags [in]
-
一个 值,该值确定是否在对话框中显示证书。 如果此值SCARD_ENROLL_NO_DISPLAY_CERT (定义为 0x01) ,则不会显示签名证书;任何其他值都会导致签名证书显示在“ 证书 ”对话框中。
-
pbstrSigningCertName [out]
-
指向返回签名证书名称的字符串的指针。 签名证书将用于对 证书请求进行签名。
返回值
C++
如果该方法成功,该方法将返回S_OK。
如果方法失败,它将返回指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 常见 HRESULT 值。
VB
一个表示签名证书名称的字符串。 签名证书将用于对 证书请求进行签名。
备注
getSigningCertificateName 方法返回 (或其他管理员) 在先前成功调用 ISCrdEnr::selectSigningCertificate 或 ISCrdEnr::setSigningCertificate 时选择的证书的使用者名称。 此方法调用 CertGetNameString 函数,以根据 为 CertGetNameString 的 dwType 参数的 CERT_NAME_SIMPLE_DISPLAY_TYPE 值描述的序列检索使用者名称。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
无受支持的版本 |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
DLL |
|
IID |
IID_ISCrdEnr定义为 753988a1-1357-436d-9cf5-f089bdd67d64 |
另请参阅