Share via


Método IOCSPAdmin::GetSigningCertificates (certadm.h)

O método GetSigningCertificates obtém os certificados de autenticação que estão disponíveis em um servidor respondente para um determinado certificado de AC (autoridade de certificação ). Esse método retorna apenas certificados de assinatura do repositório do sistema CERT_SYSTEM_STORE_LOCAL_MACHINE para o servidor especificado.

Sintaxe

HRESULT GetSigningCertificates(
  [in]  const BSTR    bstrServerName,
  [in]  const VARIANT *pCACertVar,
  [out] VARIANT       *pVal
);

Parâmetros

[in] bstrServerName

Uma cadeia de caracteres que contém o nome do respondente-servidor.

[in] pCACertVar

O certificado de autoridade de certificação para o qual recuperar certificados de autenticação.

[out] pVal

Retornar valor

C++

Se o método for bem-sucedido, ele 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

Os certificados de autenticação disponíveis.

Comentários

Cada certificado de autenticação tem as seguintes propriedades:

  • Assinado pela AC especificada pelo parâmetro pCACertVar
  • Inclui a extensão de assinatura do OCSP (Protocolo de Status de Certificado Online) (XCN_OID_PKIX_KP_OCSP_SIGNING)
  • Não expirou
  • O servidor respondente pode acessar a chave privada do certificado

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 Datacenter, Windows Server 2008 Enterprise [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certadm.h (inclua Certsrv.h)
Biblioteca Certadm.lib
DLL Certadm.dll

Confira também

IOCSPAdmin