Método IX509EnrollmentPolicyServer::Initialize (certenroll.h)

  • Artigo

O método Initialize inicializa um objeto IX509EnrollmentPolicyServer .

Sintaxe

HRESULT Initialize(
  [in] BSTR                             bstrPolicyServerUrl,
  [in] BSTR                             bstrPolicyServerId,
  [in] X509EnrollmentAuthFlags          authFlags,
  [in] VARIANT_BOOL                     fIsUnTrusted,
  [in] X509CertificateEnrollmentContext context
);

Parâmetros

[in] bstrPolicyServerUrl

Uma variável BSTR que contém a URL do servidor de política de registro de certificado.

[in] bstrPolicyServerId

Uma variável BSTR que contém uma ID exclusiva para o servidor de política de registro de certificado. Se esse valor não for NULL, ele deverá corresponder à cadeia de caracteres de ID retornada pela resposta CEP.

[in] authFlags

Um valor de enumeração X509EnrollmentAuthFlags que especifica o tipo de autenticação do cliente. Esse pode ser um dos valores a seguir.

Valor Significado
X509AuthAnonymous
 Autenticação anônima.
X509AuthKerberos
 Autenticação Kerberos.
X509AuthUsername
 Limpar o nome de usuário de texto e a autenticação de senha.
Nota O nome de usuário e a senha são criptografados antes da transmissão e armazenados com segurança no cofre de credenciais no servidor CEP.
 
X509AuthCertificate
 Certificado de autenticação do cliente instalado no computador local e usado pelo servidor para verificar a identidade do cliente.

[in] fIsUnTrusted

Um valor booliano que especifica se um certificado de autoridade de certificação não confiável deve ser permitido.

[in] context

Um valor de enumeração X509CertificateEnrollmentContext que especifica a natureza da entidade final para a qual o registro de certificado se destina. Esse pode ser um dos valores a seguir.

Valor Significado
ContextUser
 O certificado destina-se a um usuário final.
ContextMachine
 O certificado destina-se a um computador.
ContextAdministratorForceMachine
 O certificado está sendo solicitado por um administrador que atua em nome de um computador.

Retornar valor

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Código de retorno Descrição
E_INVALIDARG
 O parâmetro bstrPolicyServerUrl não pode ser uma cadeia de caracteres vazia e deve representar uma URL HTTPS.
E_OUTOFMEMORY
 Não havia memória suficiente disponível para as cadeias de caracteres especificadas nos parâmetros bstrPolicyServerUrl ou bstrPolicyServerId .
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 O objeto IX509EnrollmentPolicyServer já foi inicializado.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
 O valor especificado no parâmetro bstrPolicyServerId não é NULL e não é igual ao valor de ID de CEP existente no servidor CEP.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certenroll.h

Confira também

IX509EnrollmentPolicyServer