Ix509EnrollmentPolicyServer::SetCredential (certenroll.h)

El método SetCredential establece la credencial usada para ponerse en contacto con el servidor de la directiva de inscripción de certificados (CEP).

Sintaxis

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

Parámetros

[in] hWndParent

Identificador de ventana principal.

[in] flag

Valor de enumeración X509EnrollmentAuthFlags que especifica el tipo de autenticación. Puede ser uno de los siguientes valores.

Valor	Significado
X509AuthAnonymous	Autenticación anónima. Establezca los parámetros strCredential y strPassword en NULL.
X509AuthKerberos	Autenticación Kerberos. Establezca los parámetros strCredential y strPassword en NULL.
X509AuthUsername	Borrar el nombre de usuario y la autenticación de contraseñas de texto. Establezca los parámetros strCredential y strPassword en el nombre de usuario y la contraseña asociada. Estas cadenas se cifran antes de la transmisión y se almacenan de forma segura en el almacén de credenciales en el servidor CEP.
X509AuthCertificate	Certificado de autenticación de cliente instalado en el equipo local y usado por el servidor para comprobar la identidad del cliente. Establezca el parámetro strPassword en NULL y establezca la huella digital del certificado, un hash SHA1 de 20 bytes del certificado, en el parámetro strCredential .

[in] strCredential

Variable BSTR que contiene la credencial.

[in] strPassword

Variable BSTR que contiene la contraseña.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código devuelto	Descripción
E_INVALIDARG	El parámetro flag no es un valor admitido.

Comentarios

Los argumentos strCredential y strPassword cambiarán según el valor especificado en el argumento flag , como se muestra en la tabla siguiente.

parámetro flag	Parámetro strCredential	Parámetro strPassword
X509AuthAnonymous	NULL	NULL
X509AuthKerberos	NULL	NULL
X509AuthUsername	Borrar el nombre de usuario reconocido por el servidor CEP.	Borre la contraseña de texto asociada al nombre de usuario.
X509AuthCertificate	Contiene un hash SHA-1 de 20 bytes (huella digital) del certificado.	NULL

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certenroll.h

Consulte también

IX509EnrollmentPolicyServer