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]: 指向返回签名证书名称的字符串的指针。签名证书将用于对 证书请求进行签名。

如果该方法成功，该方法将返回S_OK。

如果方法失败，它将返回指示错误的 HRESULT 值。有关常见错误代码的列表，请参阅常见 HRESULT 值。

一个表示签名证书名称的字符串。签名证书将用于对 证书请求进行签名。

getSigningCertificateName 方法返回 (或其他管理员) 在先前成功调用 ISCrdEnr：：selectSigningCertificate 或 ISCrdEnr：：setSigningCertificate 时选择的证书的使用者名称。此方法调用 CertGetNameString 函数，以根据 为 CertGetNameString 的 dwType 参数的 CERT_NAME_SIMPLE_DISPLAY_TYPE 值描述的序列检索使用者名称。