estructura de BG_BASIC_CREDENTIALS (bits1_5.h)
Identifica el nombre de usuario y la contraseña que se van a autenticar.
Sintaxis
typedef struct __MIDL_IBackgroundCopyJob2_0001 {
LPWSTR UserName;
LPWSTR Password;
} BG_BASIC_CREDENTIALS;
Miembros
UserName
Cadena terminada en null que contiene el nombre de usuario que se va a autenticar. El nombre de usuario está limitado a 300 caracteres, no incluido el terminador null. El formato del nombre de usuario depende del esquema de autenticación solicitado. Por ejemplo, para la autenticación Basic, NTLM y Negotiate, el nombre de usuario tiene el formato DomainName UserName\. Para la autenticación de Passport, el nombre de usuario es una dirección de correo electrónico. Para obtener más información, vea la sección Comentarios.
Si es NULL, se usan credenciales predeterminadas para este contexto de sesión.
Password
Cadena terminada en null que contiene la contraseña en texto no cifrado. La contraseña está limitada a 65536 caracteres, no incluido el terminador null. La contraseña puede estar en blanco. Establézcalo en NULL si UserName es NULL. BITS cifra la contraseña antes de conservar el trabajo si se produce una desconexión de red o el usuario cierra sesión.
Las contraseñas codificadas en Live ID se admiten a través de Negotiate 2. Para obtener más información sobre los identificadores dinámicos, consulte el SDK de Windows Live ID.
Comentarios
En la lista siguiente se identifica cuándo se requieren los miembros UserName y Password en función del esquema de autenticación solicitado:
Para proteger la información de nombre de usuario y contraseña, llame a la función SecureZeroMemory , definida en Winbase.h, para borrar los búferes UserName y Password después de usar la estructura.
Puede especificar el nombre de usuario como este.
- Nombrededominio\UserName. Use DomainName UserName\ si el servidor está en un dominio y DomainName es el dominio al que pertenece el servidor o es un dominio de confianza.
- Nombredeservidor\UserName. Use NombreDeUsuario ServerName\ si la cuenta es una cuenta local en el servidor. ServerName es el nombre del equipo que autentica las credenciales.
- UserName. Si especifica solo UserName, el nombre de dominio predeterminado del usuario tiene como prefijo el nombre del usuario y se aplican las reglas para el formulario NombreDeUsuario nombreDeDominio\. Use esta opción solo si el usuario es miembro de un dominio.
- NULL. Para usar las credenciales de inicio de sesión del usuario para la autenticación NTLM o Kerberos, establezca UserName en NULL. Esto solo funciona si el usuario está en un dominio de confianza. Al establecer UserName en NULL para los servicios que se ejecutan como una cuenta del sistema, se pasan las credenciales del equipo para la autenticación. Esta opción solo funciona si el dominio habilita la autenticación Kerberos y selecciona Negociar como esquema de autenticación.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2003 |
| Encabezado | bits1_5.h (incluya Bits.h) |
| Redistribuible | BITS 1.5 en Windows XP |