ISCrdEnr：：getEnrolledCertificateName 方法

getEnrolledCertificateName 方法检索先前成功调用 ISCrdEnr：：enroll 生成的证书的名称。

此方法还可用于在对话框中显示证书。 此方法调用 CryptoAPI 函数 CertGetNameString。

语法

HRESULT getEnrolledCertificateName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pBstrCertName
);

SCrdEnr.getEnrolledCertificateName( _
  ByVal dwFlags, _
  ByRef pBstrCertName _
)

parameters

dwFlags [in]

一个 值，该值确定是否在对话框中显示证书。 如果此值SCARD_ENROLL_NO_DISPLAY_CERT (定义为 0x01) ，则不会显示已注册的证书;任何其他值都会导致已注册的证书显示在“ 证书 ”对话框中。

pBstrCertName [out]

指向返回检索到的证书名称的字符串的指针。

返回值

C++

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

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

VB

表示检索到的证书名称的字符串。

备注

由于此方法对现有证书进行操作，因此必须先成功调用 ISCrdEnr：：enroll ，然后才能调用 getEnrolledCertificateName。

getEnrolledCertificateName 方法调用 CertGetNameString 函数，以根据为 CertGetNameString 的 dwType 参数的 CERT_NAME_SIMPLE_DISPLAY_TYPE 值描述的顺序检索证书名称。

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
DLL	Scrdenrl.dll
IID	IID_ISCrdEnr定义为 753988a1-1357-436d-9cf5-f089bdd67d64

请参阅

ISCrdEnr

ISCrdEnr：：enroll