struttura SCHANNEL_CRED (schannel.h)

La struttura SCHANNEL_CRED contiene i dati per una credenziale Schannel.

Sintassi

typedef struct _SCHANNEL_CRED {
  DWORD          dwVersion;
  DWORD          cCreds;
  PCCERT_CONTEXT *paCred;
  HCERTSTORE     hRootStore;
  DWORD          cMappers;
  _HMAPPER       **aphMappers;
  struct         _HMAPPER;
  DWORD          cSupportedAlgs;
  ALG_ID         *palgSupportedAlgs;
  DWORD          grbitEnabledProtocols;
  DWORD          dwMinimumCipherStrength;
  DWORD          dwMaximumCipherStrength;
  DWORD          dwSessionLifespan;
  DWORD          dwFlags;
  DWORD          dwCredFormat;
} SCHANNEL_CRED, *PSCHANNEL_CRED;

Membri

dwVersion

Impostare su SCHANNEL_CRED_VERSION.

cCreds

Numero di strutture nella matrice paCred.

paCred

Matrice di puntatori alle strutture di CERT_CONTEXT. Ogni puntatore specifica un certificato che contiene una chiave privata da usare per l'autenticazione dell'applicazione. In genere, questa matrice contiene una struttura per ogni metodo di scambio di chiavi supportato dall'applicazione.

Le applicazioni client spesso passano un elenco vuoto e dipendono da Schannel per trovare un certificato appropriato o creare un certificato in un secondo momento, se necessario.

hRootStore

Opzionale. Valido solo per le applicazioni server. Gestire in un archivio certificati che contiene certificati radice autofirmati per le autorità di certificazione attendibili dall'applicazione. Questo membro viene usato solo dalle applicazioni lato server che richiedono l'autenticazione client.

cMappers

Riservato.

aphMappers

Riservato.

_HMAPPER

cSupportedAlgs

Numero di algoritmi nella matrice palgSupportedAlgs.

palgSupportedAlgs

Opzionale. Puntatore a una matrice di identificatori di algoritmo ALG_ID che rappresentano gli algoritmi supportati dalle connessioni effettuate con le credenziali acquisite usando questa struttura. Se cSupportedAlgs è zero o palgSupportedAlgs è NULL, Schannel usa le impostazioni predefinite di sistema.

Attualmente, gli identificatori dell'algoritmo CALG_AES, CALG_AES_128e CALG_AES_256 non sono supportati.

grbitEnabledProtocols

Opzionale. Un DWORD che contiene una stringa di bit che rappresenta i protocolli supportati dalle connessioni stabilite con le credenziali acquisite tramite questa struttura. Se questo membro è zero, Schannel seleziona il protocollo. Per il nuovo sviluppo, le applicazioni devono impostare grbitEnabledProtocols su zero e usare le versioni del protocollo abilitate nel sistema per impostazione predefinita.

Questo membro viene usato solo dal provider microsoft unified security protocol pacchetto di sicurezza.

Le impostazioni globali del Registro di sistema hanno la precedenza su questo valore. Ad esempio, se SSL3 è disabilitato nel Registro di sistema, non può essere abilitato usando questo membro.

Questo membro può contenere uno dei flag seguenti.

dwMinimumCipherStrength

Livello minimo di crittografia della crittografia bulk, in bit, consentito per le connessioni.

Se questo membro è zero, Schannel usa l'impostazione predefinita del sistema. Se questo membro è -1, vengono abilitati solo i pacchetti di crittografia SOLO SSL3/TLS (noti anche come crittografia NULL).

dwMaximumCipherStrength

Massimo livello di crittografia della crittografia bulk, in bit, consentito per le connessioni.

Se questo membro è zero, Schannel usa l'impostazione predefinita del sistema.

Se questo membro è -1, vengono abilitati solo i pacchetti di crittografia SOLO SSL3/TLS (noti anche come crittografia NULL). In questo caso, dwMinimumCipherStrength deve essere impostato su -1.

dwSessionLifespan

Numero di millisecondi in cui Schannel mantiene la sessione nella cache della sessione. Dopo che è trascorso questo periodo di tempo, tutte le nuove connessioni tra il client e il server richiedono una nuova sessione Schannel. Impostare il valore di questo membro su zero per usare il valore predefinito di 360000000 millisecondi (dieci ore).

dwFlags

Contiene flag di bit che controllano il comportamento di Schannel. Questo membro può essere zero o una combinazione dei valori seguenti.

dwCredFormat

Schannel in modalità kernel supporta i valori seguenti.

Windows Server 2008, Windows Vista, Windows Server 2003, Windows XP e Windows XP/2000: Questo flag non è supportato e deve essere zero.

Osservazioni

I flag di revoca dei certificati seguenti si escludono a vicenda.

• SCH_CRED_REVOCATION_CHECK_CHAIN
• SCH_CRED_REVOCATION_CHECK_END_CERT
• SCH_CRED_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT

Per personalizzare la segnalazione degli errori di revoca dei certificati per Schannel, usare i flag seguenti:

• SCH_CRED_IGNORE_NO_REVOCATION_CHECK
• SCH_CRED_IGNORE_REVOCATION_OFFLINE

Quando Schannel controlla lo stato di revoca di una catena di certificati, questi flag indicano rispettivamente di ignorare eventuali CRYPT_E_NO_REVOCATION_CHECK e CRYPT_E_REVOCATION_OFFLINE errori. Questi flag vengono ignorati se non è impostato alcun flag di revoca del certificato.

Fabbisogno

Vedere anche

querySecurityContextToken