estrutura BG_BASIC_CREDENTIALS (bits1_5.h)

Identifica o nome de usuário e a senha a serem autenticados.

Sintaxe

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

Membros

UserName

Uma cadeia de caracteres terminada em nulo que contém o nome de usuário a ser autenticado. O nome de usuário é limitado a 300 caracteres, não incluindo o terminador nulo. O formato do nome de usuário depende do esquema de autenticação solicitado. Por exemplo, para a autenticação Básica, NTLM e Negotiate, o nome de usuário é do formulário Nome deUsuárioDomainName\. Para autenticação do Passport, o nome de usuário é um endereço de email. Para obter mais informações, consulte Comentários.

Se FOR NULL, as credenciais padrão para este contexto de sessão serão usadas.

Password

Uma cadeia de caracteres terminada em nulo que contém a senha em texto sem formatação. A senha é limitada a 65536 caracteres, não incluindo o terminador nulo. A senha pode estar em branco. Defina-o como NULL se UserName for NULL. O BITS criptografa a senha antes de persistir o trabalho se ocorrer uma desconexão de rede ou se o usuário fizer logoff.

Há suporte para senhas codificadas em ID dinâmica por meio do Negotiate 2. Para obter mais informações sobre IDs dinâmicas, consulte o SDK do Windows Live ID.

Comentários

A lista a seguir identifica quando os membros UserName e Password são necessários com base no esquema de autenticação solicitado:

Para proteger as informações de nome de usuário e senha, chame a função SecureZeroMemory , definida em Winbase.h, para limpar os buffers UserName e Password depois de usar a estrutura.

Você pode especificar o nome de usuário assim.

• Domainname\UserName. Use DomainName\UserName se o servidor estiver em um domínio e DomainName for o domínio ao qual o servidor pertence ou se for um domínio confiável.
• Servername\UserName. Use ServerName\UserName se a conta for uma conta local no servidor. ServerName é o nome do computador que está autenticando as credenciais.
• UserName. Se você especificar apenas UserName, o nome de domínio padrão do usuário será prefixado para o nome do usuário e as regras para o formulário Nomede UsuárioDomainName\ se aplicarão. Use essa opção somente se o usuário for membro de um domínio.
• NULL. Para usar as credenciais de logon do usuário para autenticação NTLM ou Kerberos, defina UserName como NULL. Isso só funcionará se o usuário estiver em um domínio confiável. Definir UserName como NULL para serviços em execução como uma conta do sistema passa as credenciais do computador para autenticação. Essa opção funcionará somente se o domínio habilitar a autenticação Kerberos e você selecionar Negociar como o esquema de autenticação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2003
Cabeçalho	bits1_5.h (inclua Bits.h)
Redistribuível	BITS 1.5 no Windows XP

Confira também

BG_AUTH_CREDENTIALS_UNION