Share via

Método ISCrdEnr::getSigningCertificateName

  • Artigo

O método getSigningCertificateName recupera o nome da entidade do certificado de assinatura.

Esse método também pode ser usado para exibir o certificado em uma caixa de diálogo. Esse método chama a função CryptoAPICertGetNameString.

Sintaxe

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


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

Parâmetros

dwFlags [in]

Um valor que determina se o certificado é exibido em uma caixa de diálogo. Se esse valor for SCARD_ENROLL_NO_DISPLAY_CERT (definido como 0x01), o certificado de autenticação não será exibido; quaisquer outros valores resultam na exibição do certificado de autenticação na caixa de diálogo Certificado .

pbstrSigningCertName [out]

Um ponteiro para uma cadeia de caracteres que retorna o nome do certificado de autenticação. O certificado de autenticação será usado para assinar a solicitação de certificado.

Valor retornado

C++

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

Uma cadeia de caracteres que representa o nome do certificado de autenticação. O certificado de autenticação será usado para assinar a solicitação de certificado.

Comentários

O método getSigningCertificateName retorna o nome da entidade do certificado que você (ou outro administrador) selecionou em uma chamada bem-sucedida anterior para ISCrdEnr::selectSigningCertificate ou ISCrdEnr::setSigningCertificate. Esse método chama a função CertGetNameString para recuperar o nome da entidade de acordo com a sequência descrita para o valor CERT_NAME_SIMPLE_DISPLAY_TYPE do parâmetro dwType de CertGetNameString.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Nenhum compatível
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
DLL
Scrdenrl.dll
IID
 IID_ISCrdEnr é definido como 753988a1-1357-436d-9cf5-f089bdd67d64

Confira também

ISCrdEnr

ISCrdEnr::selectSigningCertificate