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 |
|
IID |
IID_ISCrdEnr定义为 753988a1-1357-436d-9cf5-f089bdd67d64 |
请参阅