ISCrdEnr::getEnrolledCertificateName 方法
getEnrolledCertificateName方法會擷取先前成功呼叫ISCrdEnr::enroll所產生的憑證名稱。
這個方法也可以用來在對話方塊中顯示憑證。 這個方法會呼叫 CryptoAPI 函式 CertGetNameString。
語法
HRESULT getEnrolledCertificateName(
[in] DWORD dwFlags,
[out] BSTR *pBstrCertName
);
SCrdEnr.getEnrolledCertificateName( _
ByVal dwFlags, _
ByRef pBstrCertName _
)
參數
-
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 |
另請參閱