Метод ISCrdEnr::getEnrolledCertificateName

  • Статья

Метод getEnrolledCertificateName извлекает имя сертификата, полученное в результате успешного вызова ISCrdEnr::enroll.

Этот метод также можно использовать для отображения сертификата в диалоговом окне. Этот метод вызывает функцию CryptoAPICertGetNameString.

Синтаксис

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, чтобы получить имя сертификата в соответствии с последовательностью, описанной для CERT_NAME_SIMPLE_DISPLAY_TYPE значения параметра dwTypeCertGetNameString.

Требования

Требование Значение
Минимальная версия клиента
 Ни одна версия не поддерживается
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
DLL
Scrdenrl.dll
IID
 IID_ISCrdEnr определяется как 753988a1-1357-436d-9cf5-f089bd67d64

См. также раздел

ISCrdEnr

ISCrdEnr::enroll