Método ISCrdEnr::getEnrolledCertificateName

O método getEnrolledCertificateName recupera o nome do certificado resultante de uma chamada bem-sucedida anterior para ISCrdEnr::enroll.

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 getEnrolledCertificateName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pBstrCertName
);

SCrdEnr.getEnrolledCertificateName( _
  ByVal dwFlags, _
  ByRef pBstrCertName _
)

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 registrado não será exibido; quaisquer outros valores fazem com que o certificado registrado seja exibido na caixa de diálogo Certificado .

pBstrCertName [out]

Um ponteiro para uma cadeia de caracteres que retorna o nome do certificado recuperado.

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 recuperado.

Comentários

Como esse método opera em um certificado existente, você deve ter chamado com êxito ISCrdEnr::enroll antes de chamar getEnrolledCertificateName.

O método getEnrolledCertificateName chama a função CertGetNameString para recuperar o nome do certificado de acordo com a sequência descrita para o valor CERT_NAME_SIMPLE_DISPLAY_TYPE do parâmetro dwType de CertGetNameString.

Requisitos

Confira também

ISCrdEnr

ISCrdEnr::enroll