BG_BASIC_CREDENTIALS Struktur (bits1_5.h)
Gibt den Benutzernamen und das Kennwort für die Authentifizierung an.
Syntax
typedef struct __MIDL_IBackgroundCopyJob2_0001 {
LPWSTR UserName;
LPWSTR Password;
} BG_BASIC_CREDENTIALS;
Member
UserName
Eine NULL-Zeichenfolge, die den zu authentifizierden Benutzernamen enthält. Der Benutzername ist auf 300 Zeichen beschränkt, ohne null-Abschlusszeichen. Das Format des Benutzernamens hängt vom angeforderten Authentifizierungsschema ab. Für die Authentifizierung "Basic", "NTLM" und "Negotiate" hat der Benutzername beispielsweise das Format DomainName\UserName. Bei der Passport-Authentifizierung ist der Benutzername eine E-Mail-Adresse. Weitere Informationen finden Sie in den Hinweisen.
Bei NULL werden die Standardanmeldeinformationen für diesen Sitzungskontext verwendet.
Password
Eine NULL-Zeichenfolge, die das Kennwort in Klartext enthält. Das Kennwort ist auf 65536 Zeichen beschränkt, ohne den Nullabschluss. Das Kennwort kann leer sein. Legen Sie es auf NULL fest, wenn UserNameNULL ist. BITS verschlüsselt das Kennwort, bevor der Auftrag beibehalten wird, wenn eine Netzwerkverbindung auftritt oder sich der Benutzer abmeldet.
Live-ID-codierte Kennwörter werden über Negotiate 2 unterstützt. Weitere Informationen zu Live-IDs finden Sie im Windows Live ID SDK.
Hinweise
In der folgenden Liste wird anhand des angeforderten Authentifizierungsschemas angegeben, wann die Member "Benutzername " und "Kennwort " erforderlich sind:
Um die Benutzernamen- und Kennwortinformationen zu schützen, rufen Sie die in Winbase.h definierte SecureZeroMemory-Funktion auf, um die Puffer "Benutzername " und "Kennwort " zu löschen, nachdem Sie die Struktur verwendet haben.
Sie können den Benutzernamen wie folgt angeben.
- Domänenname\Benutzername. Verwenden Sie DomainName\UserName , wenn sich der Server in einer Domäne befindet und der DomainName die Domäne ist, zu der der Server gehört oder eine vertrauenswürdige Domäne ist.
- Servername\Benutzername. Verwenden Sie ServerName\UserName , wenn es sich bei dem Konto um ein lokales Konto auf dem Server handelt. ServerName ist der Name des Computers, der die Anmeldeinformationen authentifiziert.
- Benutzername. Wenn Sie nur Benutzername angeben, wird dem Standarddomänennamen des Benutzers der Name des Benutzers vorangestellt, und die Regeln für das Formular DomainName\UserName gelten. Verwenden Sie diese Option nur, wenn der Benutzer Mitglied einer Domäne ist.
- NULL. Um die Anmeldeinformationen des Benutzers für die NTLM- oder Kerberos-Authentifizierung zu verwenden, legen Sie UserName auf NULL fest. Dies funktioniert nur, wenn sich der Benutzer in einer vertrauenswürdigen Domäne befindet. Durch Festlegen von UserName auf NULL für Dienste, die als Systemkonto ausgeführt werden, werden die Anmeldeinformationen des Computers für die Authentifizierung übergeben. Diese Option funktioniert nur, wenn die Domäne die Kerberos-Authentifizierung aktiviert und Sie Aushandeln als Authentifizierungsschema auswählen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Kopfzeile | bits1_5.h (bits.h einschließen) |
| Verteilbare Komponente | BITS 1.5 unter Windows XP |