Struttura SecPkgInfoA (sspi.h)

Articolo
11/20/2024

La struttura di SecPkgInfo fornisce informazioni generali su un pacchetto di sicurezza , ad esempio il nome e le funzionalità.

Sintassi

typedef struct _SecPkgInfoA {
  unsigned long  fCapabilities;
  unsigned short wVersion;
  unsigned short wRPCID;
  unsigned long  cbMaxToken;
  SEC_CHAR       *Name;
  SEC_CHAR       *Comment;
} SecPkgInfoA, *PSecPkgInfoA;

Membri

fCapabilities

Set di flag di bit che descrivono le funzionalità del pacchetto di sicurezza. Questo membro può essere una combinazione dei flag seguenti.

Valore	Significato
SECPKG_FLAG_INTEGRITY 0x1	Il pacchetto di sicurezza supporta le funzioni MakeSignature e VerifySignature.
SECPKG_FLAG_PRIVACY 0x2	Il pacchetto di sicurezza supporta le funzioni di EncryptMessage (Generale) e DecryptMessage (Generale) .
SECPKG_FLAG_TOKEN_ONLY 0x4	Il pacchetto è interessato solo alla parte del token di sicurezza dei messaggi e ignorerà eventuali altri buffer. Si tratta di un problema correlato alle prestazioni.
SECPKG_FLAG_DATAGRAM 0x8	Supporta 'autenticazione di tipo datagram. Per altre informazioni, vedere SSPI Context Semantics. importante Il pacchetto di Kerberos di Microsoft non supporta i contesti di datagrammi in modalità utente-utente.
SECPKG_FLAG_CONNECTION 0x10	Supporta l'autenticazione orientata alla connessione. Per altre informazioni, vedere SSPI Context Semantics.
SECPKG_FLAG_MULTI_REQUIRED 0x20	Per l'autenticazione sono necessarie più gambe.
SECPKG_FLAG_CLIENT_ONLY 0x40	Il supporto per l'autenticazione server non è disponibile.
SECPKG_FLAG_EXTENDED_ERROR 0x80	Supporta la gestione degli errori estesa. Per altre informazioni, vedere informazioni sull'errore esteso.
SECPKG_FLAG_IMPERSONATION 0x100	Supporta la rappresentazione di Windows nei contesti del server.
SECPKG_FLAG_ACCEPT_WIN32_NAME 0x200	Informazioni sui nomi di entità e destinazione di Windows.
SECPKG_FLAG_STREAM 0x400	Supporta la semantica del flusso. Per altre informazioni, vedere SSPI Context Semantics.
SECPKG_FLAG_NEGOTIABLE 0X800	Può essere usato dal pacchetto di sicurezza Microsoft Negotiate.
SECPKG_FLAG_GSS_COMPATIBLE 0x1000	Supporta la compatibilità GSS.
SECPKG_FLAG_LOGON 0x2000	Supporta LsaLogonUser.
SECPKG_FLAG_ASCII_BUFFERS 0x4000	I buffer dei token sono in formato caratteri ASCII.
SECPKG_FLAG_FRAGMENT 0x8000	Supporta la separazione di token di grandi dimensioni in buffer più piccoli in modo che le applicazioni possano effettuare chiamate ripetute a InitializeSecurityContext (Generale) e AcceptSecurityContext (Generale) con i buffer più piccoli per completare l'autenticazione.
SECPKG_FLAG_MUTUAL_AUTH 0x10000	Supporta l'autenticazione reciproca.
SECPKG_FLAG_DELEGATION 0x20000	Supporta la delega.
SECPKG_FLAG_READONLY_WITH_CHECKSUM 0x40000	Il pacchetto di sicurezza supporta l'uso di un checksum anziché la crittografia sul posto quando si chiama la funzione EncryptMessage .
SECPKG_FLAG_RESTRICTED_TOKENS 0x80000	Supporta i chiamanti con token limitati.
SECPKG_FLAG_NEGO_EXTENDER 0x00100000	Il pacchetto di sicurezza estende il pacchetto di sicurezza Microsoft Negotiate. Può essere presente al massimo un pacchetto di questo tipo.
SECPKG_FLAG_NEGOTIABLE2 0x00200000	Questo pacchetto viene negoziato dal pacchetto di tipo SECPKG_FLAG_NEGO_EXTENDER.
SECPKG_FLAG_APPCONTAINER_PASSTHROUGH 0x00400000	Questo pacchetto riceve tutte le chiamate dalle app contenitore di app.
SECPKG_FLAG_APPCONTAINER_CHECKS 0x00800000	Questo pacchetto riceve chiamate dalle app del contenitore di app se uno dei controlli seguenti ha esito positivo. Il chiamante ha la funzionalità di credenziali predefinite. La destinazione è un server proxy. Il chiamante ha fornito le credenziali.
SECPKG_CALLFLAGS_APPCONTAINER 0x00000001	Il chiamante è un contenitore di app.
SECPKG_CALLFLAGS_AUTHCAPABLE 0x00000002	Il chiamante può usare le credenziali predefinite.
SECPKG_CALLFLAGS_FORCE_SUPPLIED 0x00000004	Il chiamante può usare solo le credenziali fornite.

wVersion

Specifica la versione del protocollo del pacchetto. Deve essere 1.

wRPCID

Specifica un identificatore RPC DCE, se appropriato. Se il pacchetto non implementa uno dei sistemi di sicurezza registrati da DCE, viene usato il valore riservato SECPKG_ID_NONE.

cbMaxToken

Specifica le dimensioni massime, in byte, del token.

Name

Puntatore a una stringa con terminazione Null contenente il nome del pacchetto di sicurezza.

Comment

Puntatore a una stringa con terminazione Null. Può trattarsi di qualsiasi stringa aggiuntiva passata di nuovo dal pacchetto.

Osservazioni

Nota

L'intestazione sspi.h definisce SecPkgInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	sspi.h (include Security.h)

Vedere anche

EnumerateSecurityPackages

QuerySecurityPackageInfo

Condividi tramite