Поделиться через

структура BG_BASIC_CREDENTIALS (bits1_5.h)

  • Статья

Определяет имя пользователя и пароль для проверки подлинности.

Синтаксис

typedef struct __MIDL_IBackgroundCopyJob2_0001 {
  LPWSTR UserName;
  LPWSTR Password;
} BG_BASIC_CREDENTIALS;

Члены

UserName

Строка, завершающаяся нулевым значением, которая содержит имя пользователя для проверки подлинности. Имя пользователя может содержать не более 300 символов, не включая символ конца null. Формат имени пользователя зависит от запрошенной схемы проверки подлинности. Например, для проверки подлинности Basic, NTLM и Negotiate имя пользователя имеет вид Имя_\пользователя домена. Для проверки подлинности Passport именем пользователя является адрес электронной почты. Дополнительные сведения см. в подразделе "Примечания".

Если значение РАВНО NULL, используются учетные данные по умолчанию для этого контекста сеанса.

Password

Строка, завершающаяся значением NULL, которая содержит пароль в виде открытого текста. Длина пароля ограничена 65536 символами, не включая символ конца null. Пароль может быть пустым. Присвойте ему значение NULL , если UserName имеет значение NULL. BITS шифрует пароль перед сохранением задания в случае отключения сети или выхода пользователя из системы.

Пароли в кодировке Live ID поддерживаются через согласование 2. Дополнительные сведения о динамических идентификаторах см. в статье Windows Live ID SDK.

Комментарии

В следующем списке показано, когда требуются элементы UserName и Password на основе запрошенной схемы проверки подлинности.

Чтобы защитить сведения об имени пользователя и пароле, вызовите функцию SecureZeroMemory , определенную в Winbase.h, чтобы очистить буферы UserName и Password после использования структуры.

Имя пользователя можно указать следующим образом.

  • Domainname\UserName. Используйте имя_\пользователя домена, если сервер находится в домене, а имя_домена является доменом, к которому принадлежит сервер, или является доверенным доменом.
  • Имя _сервера\UserName. Используйте имя_\пользователя сервера, если учетная запись является локальной учетной записью на сервере. ServerName — это имя компьютера, который выполняет проверку подлинности учетных данных.
  • UserName. Если указать только UserName, доменное имя пользователя по умолчанию будет префиксом имени пользователя и применяются правила для формыИмя_пользователядомена\. Используйте этот параметр, только если пользователь является членом домена.
  • NULL. Чтобы использовать учетные данные для входа пользователя для проверки подлинности NTLM или Kerberos, задайте для параметра UserNameзначение NULL. Это работает только в том случае, если пользователь находится в доверенном домене. Для параметра UserName значение NULL для служб, работающих как системная учетная запись, передаются учетные данные компьютера для проверки подлинности. Этот параметр работает только в том случае, если домен включает проверку подлинности Kerberos и в качестве схемы проверки подлинности выбран вариант Согласование.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2003
Верхняя часть bits1_5.h (включая Bits.h)
Распространяемые компоненты BITS 1.5 в Windows XP

См. также раздел

BG_AUTH_CREDENTIALS_UNION