Método ISCrdEnr::getCAName

O método getCAName recupera o nome da AC (autoridade de certificação ) especificada para um determinado modelo de certificado.

Sintaxe

HRESULT getCAName(
  [in]  DWORD     dwFlags,
  [in]  BSTR     bstrCertTemplateName,
  [out] BSTR *pbstrCAName
);

SCrdEnr.getCAName( _
  ByVal dwFlags, _
  ByVal bstrCertTemplateName, _
  ByRef pbstrCAName _
)

Parâmetros

dwFlags [in]

Um valor que determina se o nome se refere ao nome da AC ou ao nome do computador da AC. Se esse valor for SCARD_ENROLL_CA_MACHINE_NAME (definido como 0x01), o nome se referirá ao nome do computador da AC; caso contrário, o nome se refere ao nome da AC.

bstrCertTemplateName [in]

O nome do modelo de certificado.

pbstrCAName [out]

Um ponteiro para uma cadeia de caracteres que retorna o nome da AC.

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 da AC.

Comentários

O nome padrão da AC é o primeiro nome na lista disponível de ACs.

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::enumCAName

ISCrdEnr::getCACount

ISCrdEnr::setCAName