Метод ISCrdEnr::getSigningCertificateName

  • Статья

Метод getSigningCertificateName извлекает имя субъекта из сертификата подписи.

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

Синтаксис

HRESULT getSigningCertificateName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pbstrSigningCertName
);


SCrdEnr.getSigningCertificateName( _
  ByVal dwFlags, _
  ByRef pbstrSigningCertName _
)

Параметры

dwFlags [in]

Значение типа , определяющее, отображается ли сертификат в диалоговом окне. Если это значение равно SCARD_ENROLL_NO_DISPLAY_CERT (определяется как 0x01), сертификат подписи не отображается; Любые другие значения приводят к отображению сертификата подписи в диалоговом окне Сертификат .

pbstrSigningCertName [out]

Указатель на строку, возвращающую имя сертификата подписи. Сертификат подписи будет использоваться для подписи запроса на сертификат.

Возвращаемое значение

C++

Если метод завершается успешно, метод возвращает S_OK.

Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

VB

Строка, представляющая имя сертификата подписи. Сертификат подписи будет использоваться для подписи запроса на сертификат.

Комментарии

Метод getSigningCertificateName возвращает имя субъекта сертификата, выбранного вами (или другим администратором) в предыдущем успешном вызове ISCrdEnr::selectSigningCertificate или ISCrdEnr::setSigningCertificate. Этот метод вызывает функцию CertGetNameString для получения имени субъекта в соответствии с последовательностью, описанной для CERT_NAME_SIMPLE_DISPLAY_TYPE значения параметра dwTypeCertGetNameString.

Требования

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

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

ISCrdEnr

ISCrdEnr::selectSigningCertificate