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

Artigo
02/23/2024

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

Compartilhar via