struttura SEC_WINNT_AUTH_IDENTITY_EX2 (sspi.h)
Contiene informazioni su un'identità di autenticazione. La struttura SEC_WINNT_AUTH_IDENTITY_EX2 contiene i dati di autenticazione forniti alla funzione AcquireCredentialsHandle.
Sintassi
typedef struct _SEC_WINNT_AUTH_IDENTITY_EX2 {
unsigned long Version;
unsigned short cbHeaderLength;
unsigned long cbStructureLength;
unsigned long UserOffset;
unsigned short UserLength;
unsigned long DomainOffset;
unsigned short DomainLength;
unsigned long PackedCredentialsOffset;
unsigned short PackedCredentialsLength;
unsigned long Flags;
unsigned long PackageListOffset;
unsigned short PackageListLength;
} SEC_WINNT_AUTH_IDENTITY_EX2, *PSEC_WINNT_AUTH_IDENTITY_EX2;
Membri
Version
Numero di versione della struttura. Deve essere SEC_WINNT_AUTH_IDENTITY_VERSION_2.
cbHeaderLength
Dimensione, in byte, dell'intestazione della struttura.
cbStructureLength
Dimensione, in byte, della struttura.
UserOffset
Offset dall'inizio della struttura all'inizio della stringa del nome utente.
UserLength
Dimensione, in byte, della stringa del nome utente.
DomainOffset
Offset dall'inizio della struttura all'inizio della stringa del nome di dominio.
Una credenziale di identità deve contenere il nome del provider di identità anziché il nome di dominio.
DomainLength
Dimensione, in byte, della stringa del nome di dominio.
PackedCredentialsOffset
Offset dall'inizio della struttura all'inizio delle credenziali compresse.
La credenziale compressa è una struttura SEC_WINNT_AUTH_PACKED_CREDENTIALS che contiene un tipo di credenziale che specifica in modo univoco il tipo di credenziale.
PackedCredentialsLength
Dimensione, in byte, della stringa di credenziali compressa.
Flags
Flag di di long non firmato
| Valore | Significato |
|---|---|
|
Tutti i dati si trovano in un unico buffer. |
|
Usato con il provider di (SSP) |
|
Le credenziali sono in formato ANSI. |
|
Le credenziali sono in formato Unicode. |
|
Quando il tipo di credenziale è password, la presenza di questo flag specifica che la struttura è una credenziale ID online. I membri DomainOffset e DomainLength corrispondono al nome del provider ID online.
Windows Server 2008 R2 e Windows 7: Questo flag non è supportato. |
|
La struttura viene crittografata dalla funzione SspiEncryptAuthIdentity o dalla funzione SspiEncryptAuthIdentityEx con l'opzione SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_PROCESS. Può essere decrittografata solo dallo stesso processo.
Windows Server 2008 R2 e Windows 7: Questo flag non è supportato. |
|
La struttura viene crittografata dalla funzione SspiEncryptAuthIdentityEx con l'opzione SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON nel contesto di sicurezza SYSTEM. Può essere decrittografata solo da un thread in esecuzione come SYSTEM.
Windows Server 2008 R2 e Windows 7: Questo flag non è supportato. |
|
La struttura viene crittografata dalla funzione Windows Server 2008 R2 e Windows 7: Questo flag non è supportato. |
|
Il buffer di identità di autenticazione è cbStructureLength + 8 byte di riempimento necessari per la crittografia sul posto o la decrittografia dell'identità. |
PackageListOffset
Offset dall'inizio della struttura all'inizio dell'elenco di pacchetti supportati.
PackageListLength
Dimensioni, in byte, dell'elenco di pacchetti supportati.
Osservazioni
Questo buffer di identità di autenticazione può essere restituito da diverse API delle credenziali, ad esempio il metodo GetSerialization e il metodo CredUIPromptForWindowsCredential e funzioni di SspiPromptForCredentials.
La struttura descrive un'intestazione del buffer di identità di autenticazione e i dati vengono accodati alla fine della struttura. Anche se le dimensioni del buffer sono specificate dal membro cbStructureLength
La struttura SEC_WINNT_AUTH_IDENTITY_EX2 può essere restituita da QueryContextAttributes(CredSSP) e utilizzata da AcquireCredentialsHandle(CredSSP), LsaLogonUsere altre interfacce del provider di identità.
SEC_WINNT_AUTH_PACKED_CREDENTIALS può contenere un tipo di credenziale della password, definito come SEC_WINNT_AUTH_DATA_TYPE_PASSWORD. Questo tipo di credenziale descrive le credenziali password di un utente di dominio e altre identità online. Le applicazioni devono definire _SEC_WINNT_AUTH_TYPES per compilare il codice che fa riferimento a questo tipo di credenziale e ad altre definizioni della struttura SEC_WINNT_AUTH_PACKED_CREDENTIALS.
Le applicazioni non devono eseguire query o impostare direttamente il membro flag di
I provider di identità devono controllare o impostare in modo esplicito SEC_WINNT_AUTH_IDENTITY_FLAGS_ID_PROVIDER e i campi del nome di dominio per differenziare le credenziali delle password da una password di dominio e da un altro provider di identità.
È possibile chiamare la funzione CredPackAuthenticationBuffer
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 7 [solo app desktop] |
| server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| intestazione |
sspi.h |