Funzione QueryContextAttributesExA (sspi.h)
Consente a un'applicazione di trasporto di eseguire query su un pacchetto di sicurezza per determinati attributi di di un contesto di sicurezza .
Sintassi
SECURITY_STATUS SEC_ENTRY QueryContextAttributesExA(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer,
[in] unsigned long cbBuffer
);
Parametri
[in] phContext
Handle per il contesto di sicurezza su cui eseguire una query.
[in] ulAttribute
Specifica l'attributo del contesto da restituire. Questo parametro può essere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_AccessToken.
Restituisce un handle al token di accesso. |
|
Il parametro pBuffer Restituisce o specifica i dati dell'applicazione per la sessione. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel. |
|
Il parametro pBuffer Esegue una query sul nome dell'autorità di autenticazione. |
|
Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_ClientSpecifiedTarget che rappresenta il nome dell'entità servizio (SPN) della destinazione iniziale fornita dal client.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato. |
|
Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_ConnectionInfo.
Restituisce informazioni dettagliate sulla connessione stabilita. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel. |
|
Il parametro pBuffer Se le credenziali client sono nome utente e password, il buffer è una struttura KERB_INTERACTIVE_LOGON compressa. Se le credenziali client sono nome utente e PIN smart card, il buffer è una struttura KERB_CERTIFICATE_LOGON compressa. Se le credenziali client sono credenziali di identità online, il buffer è una struttura di SEC_WINNT_AUTH_IDENTITY_EX2 di marshalling. Questo attributo è supportato solo nel server CredSSP. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato. |
|
Il parametro pBuffer Query per i dati di autorizzazione usati dai servizi DCE. |
|
Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_Bindings che specifica le informazioni di associazione del canale.
Questo attributo è supportato solo dal pacchetto di sicurezza Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato. |
|
Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_EapKeyBlock.
Esegue query sui dati chiave usati dal protocollo TLS EAP. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel. |
|
Il parametro pBuffer Restituisce informazioni sui flag di contesto negoziati. |
|
Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_IssuerListInfoEx.
Restituisce un elenco di autorità emittenti di certificati accettate dal server. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel. |
|
Il parametro pBuffer Esegue una query sulle chiavi usate in un contesto di sicurezza. |
|
Il parametro pBuffer Questo valore è supportato solo dai pacchetti di sicurezza Negotiate, Kerberos e NTLM. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato. |
|
Il parametro pBuffer Esegue una query sull'intervallo di vita del contesto. |
|
Il parametro pBuffer contiene un puntatore a una struttura PCCERT_CONTEXT.
Trova un contesto certificato che contiene un certificato finale locale. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel. |
|
Il parametro pBuffer Sostituito da SECPKG_ATTR_LOCAL_CERT_CONTEXT. |
|
Il parametro pBuffer Esegue una query sul nome associato al contesto. |
|
Il parametro pBuffer Restituisce il nome dell'entità (CNAME) dal ticket in uscita. |
|
Il parametro pBuffer Restituisce informazioni sul pacchetto di sicurezza da utilizzare con il processo di negoziazione e lo stato corrente della negoziazione per l'utilizzo di tale pacchetto. |
|
Il parametro pBuffer Restituisce informazioni sul provider di servizi condivisi in uso. |
|
Il parametro pBuffer Restituisce le informazioni sulla scadenza delle password. |
|
Il parametro pBuffer contiene un puntatore a una struttura PCCERT_CONTEXT.
Trova un contesto certificato che contiene il certificato finale fornito dal server. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel. |
|
Il parametro pBuffer |
|
Il parametro pBuffer Restituisce informazioni sulle chiavi di sessione. |
|
Il parametro pBuffer Restituisce informazioni sulla sessione. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel. |
|
Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_Sizes.
Esegue una query sulle dimensioni delle strutture usate nelle funzioni per messaggio. |
|
Il parametro pBuffer Esegue una query sulle dimensioni delle varie parti di un flusso usato nelle funzioni per messaggio. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel. |
|
Il parametro pBuffer Questo valore restituisce informazioni sugli attributi di sicurezza per la connessione. Questo valore è supportato solo nel server CredSSP. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato. |
|
Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_SupportedSignatures.
Questo valore restituisce informazioni sui tipi di firma supportati per la connessione. Questo valore è supportato solo dal pacchetto di sicurezza Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato. |
|
Il parametro pBuffer Restituisce informazioni sul nome del server remoto. |
|
Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_Bindings che specifica le informazioni di associazione del canale.
Questo valore è supportato solo dal pacchetto di sicurezza Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato. |
[out] pBuffer
Puntatore a una struttura che riceve gli attributi. Il tipo di struttura a cui punta dipende dal valore specificato nel parametro ulAttribute.
[in] cbBuffer
Dimensione, in byte, del parametro
Valore restituito
Se la funzione ha esito positivo, il valore restituito è SEC_E_OK.
Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero.
Osservazioni
Nota
L'intestazione sspi.h definisce QueryContextAttributesEx 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] |
| piattaforma di destinazione | Finestre |
| intestazione |
sspi.h (include Security.h) |
| libreria |
Secur32.lib |
| dll | Secur32.dll |