Partager via

structure BG_BASIC_CREDENTIALS (bits1_5.h)

  • Article

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

Voir aussi

BG_AUTH_CREDENTIALS_UNION