structure BG_BASIC_CREDENTIALS (bits1_5.h)
Identifie le nom d’utilisateur et le mot de passe à authentifier.
Syntaxe
typedef struct __MIDL_IBackgroundCopyJob2_0001 {
LPWSTR UserName;
LPWSTR Password;
} BG_BASIC_CREDENTIALS;
Membres
UserName
Chaîne terminée par null qui contient le nom d’utilisateur à authentifier. Le nom d’utilisateur est limité à 300 caractères, à l’exception de la fin null. Le format du nom d’utilisateur dépend du schéma d’authentification demandé. Par exemple, pour l’authentification De base, NTLM et Negotiate, le nom d’utilisateur est au format Nom_\utilisateur de domaine. Pour l’authentification Passport, le nom d’utilisateur est une adresse e-mail. Pour plus d'informations, consultez la section Notes.
Si la valeur est NULL, les informations d’identification par défaut de ce contexte de session sont utilisées.
Password
Chaîne terminée par null qui contient le mot de passe en texte clair. Le mot de passe est limité à 65536 caractères, à l’exception de la fin null. Le mot de passe peut être vide. Définissez-le sur NULL si UserName a la valeur NULL. BITS chiffre le mot de passe avant de conserver le travail si une déconnexion réseau se produit ou si l’utilisateur se déconnecte.
Les mots de passe encodés live ID sont pris en charge via Negotiate 2. Pour plus d’informations sur live ID, consultez le Kit de développement logiciel (SDK) Windows Live ID.
Remarques
La liste suivante identifie quand les membres UserName et Password sont requis en fonction du schéma d’authentification demandé :
Pour protéger les informations de nom d’utilisateur et de mot de passe, appelez la fonction SecureZeroMemory , définie dans Winbase.h, pour effacer les mémoires tampons UserName et Password après avoir utilisé la structure.
Vous pouvez spécifier le nom d’utilisateur comme suit.
- Domainname\UserName. Utilisez DomainName\UserName si le serveur se trouve dans un domaine et que DomainName est le domaine auquel le serveur appartient ou est un domaine approuvé.
- Servername\UserName. Utilisez ServerName\UserName si le compte est un compte local sur le serveur. ServerName est le nom de l’ordinateur qui authentifie les informations d’identification.
- UserName. Si vous spécifiez uniquement UserName, le nom de domaine par défaut de l’utilisateur est préfixé au nom de l’utilisateur et les règles du formulaire Nomd’utilisateurDomainName\ s’appliquent. Utilisez cette option uniquement si l’utilisateur est membre d’un domaine.
- NULL. Pour utiliser les informations d’identification d’ouverture de session de l’utilisateur pour l’authentification NTLM ou Kerberos, définissez UserName sur NULL. Cela fonctionne uniquement si l’utilisateur se trouve dans un domaine approuvé. La définition de UserName sur NULL pour les services s’exécutant en tant que compte système transmet les informations d’identification de l’ordinateur pour l’authentification. Cette option fonctionne uniquement si le domaine active l’authentification Kerberos et que vous sélectionnez Négocier comme schéma d’authentification.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2003 |
| En-tête | bits1_5.h (incluez Bits.h) |
| Composant redistribuable | BITS 1.5 sur Windows XP |