Compartilhar via

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

  • Artigo

O método SetCredential define a credencial usada para entrar em contato com o servidor cep (política de registro de certificado).

Sintaxe

HRESULT SetCredential(
  [in] LONG                    hWndParent,
  [in] X509EnrollmentAuthFlags flag,
  [in] BSTR                    strCredential,
  [in] BSTR                    strPassword
);

Parâmetros

[in] hWndParent

Identificador de janela pai.

[in] flag

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

Valor Significado
X509AuthAnonymous
 Autenticação anônima. Defina os parâmetros strCredential e strPassword comoNULL.
X509AuthKerberos
 Autenticação Kerberos. Defina os parâmetros strCredential e strPassword comoNULL.
X509AuthUsername
 Limpar o nome de usuário de texto e a autenticação de senha. Defina os parâmetros strCredential e strPassword como o nome de usuário e a senha associada. Essas cadeias de caracteres são criptografadas antes da transmissão e são armazenadas 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. Defina o parâmetro strPassword comoNULL e defina a impressão digital do certificado, um hash SHA1 de 20 bytes do certificado, no parâmetro strCredential .

[in] strCredential

Uma variável BSTR que contém a credencial.

[in] strPassword

Uma variável BSTR que contém a senha.

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 sinalizador não é um valor com suporte.

Comentários

Os argumentos strCredential e strPassword serão alterados dependendo do valor especificado no argumento sinalizador , conforme mostrado na tabela a seguir.

parâmetro flag Parâmetro strCredential Parâmetro strPassword
X509AuthAnonymous NULL NULL
X509AuthKerberos NULL NULL
X509AuthUsername Limpar o nome de usuário de texto reconhecido pelo servidor CEP. Limpar senha de texto associada ao nome de usuário.
X509AuthCertificate Contém um hash SHA-1 de 20 bytes (impressão digital) do certificado. NULL

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