Condividi tramite


BG_BASIC_CREDENTIALS struttura (bits1_5.h)

Identifica il nome utente e la password da autenticare.

Sintassi

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

Members

UserName

Stringa con terminazione null contenente il nome utente da autenticare. Il nome utente è limitato a 300 caratteri, non incluso il terminatore Null. Il formato del nome utente dipende dallo schema di autenticazione richiesto. Ad esempio, per l'autenticazione Basic, NTLM e Negotiate, il nome utente è del nome utente nomeutente nome dominio\. Per l'autenticazione passport, il nome utente è un indirizzo di posta elettronica. Per altre informazioni, vedere la sezione Osservazioni.

Se NULL, vengono usate le credenziali predefinite per questo contesto di sessione.

Password

Stringa con terminazione null contenente la password in testo non crittografato. La password è limitata a 65536 caratteri, non incluso il terminatore Null. La password può essere vuota. Impostarlo su NULL se UserName è NULL. BITS crittografa la password prima di rendere persistente il processo se si verifica una disconnessione di rete o l'utente si disconnette.

Le password codificate con ID live sono supportate tramite Negozi 2. Per altre informazioni sugli ID live, vedere Windows Live ID SDK.

Commenti

L'elenco seguente identifica quando i membri UserName e Password sono necessari in base allo schema di autenticazione richiesto:

Per proteggere le informazioni sul nome utente e sulla password, chiamare la funzione SecureZeroMemory , definita in Winbase.h, per cancellare i buffer UserName e Password dopo aver usato la struttura.

È possibile specificare il nome utente come questo.

  • Domainname\UserName. Usare DomainName\UserName se il server si trova in un dominio e DomainName è il dominio a cui appartiene il server o è un dominio attendibile.
  • Nomeserver\UserName. Usare ServerName UserName\ se l'account è un account locale nel server. ServerName è il nome del computer che esegue l'autenticazione delle credenziali.
  • UserName. Se si specifica solo UserName, il nome di dominio predefinito dell'utente viene preceduto dal nome dell'utente e le regole per il modulo DomainName\UserName si applicano. Usare questa opzione solo se l'utente è membro di un dominio.
  • NULL. Per usare le credenziali di accesso dell'utente per l'autenticazione NTLM o Kerberos, impostare UserName su NULL. Questa operazione funziona solo se l'utente si trova in un dominio attendibile. L'impostazione di UserName su NULL per i servizi in esecuzione come account di sistema passa le credenziali del computer per l'autenticazione. Questa opzione funziona solo se il dominio abilita l'autenticazione Kerberos e si seleziona Negozia come schema di autenticazione.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2003
Intestazione bits1_5.h (includere Bits.h)
Componente ridistribuibile BITS 1.5 in Windows XP

Vedi anche

BG_AUTH_CREDENTIALS_UNION