Funzione QueryContextAttributes (CredSSP)

Articolo
06/13/2023

La funzione QueryContextAttributes (CredSSP) consente a un'applicazione di trasporto di eseguire una query sul pacchetto di sicurezza CredSSP (Credential Security Support Provider) per determinati attributi di un contesto di sicurezza.

Sintassi

SECURITY_STATUS SEC_ENTRY QueryContextAttributes(
  _In_  PCtxtHandle phContext,
  _In_  ULONG       ulAttribute,
  _Out_ PVOID       pBuffer
);

Parametri

phContext [in]

Handle per il contesto di sicurezza su cui eseguire query.

ulAttribute [in]

Attributo del contesto da restituire. Questo parametro può avere uno dei valori seguenti. Se non diversamente specificato, gli attributi sono applicabili sia al client che al server.

Valore	Significato
SECPKG_ATTR_C_ACCESS_TOKEN 0x80000012	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_AccessToken che specifica il token di accesso per il contesto di sicurezza corrente. Questo attributo è supportato solo nel server.
SECPKG_ATTR_C_FULL_ACCESS_TOKEN 0x80000082	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_AccessToken che specifica il token di accesso per il contesto di sicurezza corrente. Questo attributo è supportato solo nel server.
SECPKG_ATTR_CERT_TRUST_STATUS 0x80000084	Il parametro pBuffer contiene un puntatore a una struttura CERT_TRUST_STATUS che specifica informazioni di attendibilità sul certificato. Questo attributo è supportato solo nel client.
SECPKG_ATTR_CREDS 0x80000080	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_ClientCreds che specifica le credenziali client. Le credenziali client possono essere nome utente e password o nome utente e PIN smart card. Questo attributo è supportato solo nel server.
SECPKG_ATTR_CREDS_2 0x80000086	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_ClientCreds che specifica le credenziali client. Se le credenziali client sono nome utente e password, il buffer è una struttura di KERB_INTERACTIVE_LOGON compressa. Se la credenziale client è il nome utente e il PIN della smart card, il buffer è una struttura di 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.
SECPKG_ATTR_NEGOTIATION_PACKAGE 0x80000081	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_PackageInfo che specifica il nome del pacchetto di autenticazione negoziato dal provider Microsoft Negotiate .
SECPKG_ATTR_PACKAGE_INFO 10	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_PackageInfo. Restituisce informazioni sul provider di servizi condivisi in uso.
SECPKG_ATTR_SERVER_AUTH_FLAGS 0x80000083	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_Flags che specifica informazioni sui flag nel contesto di sicurezza corrente. Questo attributo è supportato solo nel client.
SECPKG_ATTR_SIZES 0x0	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_Sizes . Esegue una query sulle dimensioni delle strutture usate nelle funzioni per messaggio e negli scambi di autenticazione.
SECPKG_ATTR_SUBJECT_SECURITY_ATTRIBUTES 124	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_SubjectAttributes . 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.

pBuffer [out]

Puntatore a una struttura che riceve gli attributi. Il tipo di struttura dipende dal valore del parametro ulAttribute .

Valore restituito

Se la funzione ha esito positivo, restituisce SEC_E_OK.

Se la funzione ha esito negativo, può restituire i codici di errore seguenti.

Codice/valore restituito	Descrizione
SEC_E_INVALID_HANDLE 0x80100003	La funzione non è riuscita. Il parametro phContext specifica un handle per un contesto incompleto.
SEC_E_UNSUPPORTED_FUNCTION 0x80090302	La funzione non è riuscita. Il valore del parametro ulAttribute non è valido.

Commenti

La struttura a cui punta il parametro pBuffer varia a seconda dell'attributo su cui viene eseguita la query.

Mentre il chiamante deve allocare la struttura pBuffer stessa, il provider di servizi condivisi alloca qualsiasi memoria necessaria per contenere membri di dimensioni variabili della struttura pBuffer . La memoria allocata dal provider di servizi condivisi deve essere liberata chiamando la funzione FreeContextBuffer .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Sspi.h (include Security.h)
Libreria	Secur32.lib
DLL	Secur32.dll
Nomi Unicode e ANSI	QueryContextAttributesW (Unicode) e QueryContextAttributesA (ANSI)

Vedi anche

Funzioni SSPI
CERT_CONTEXT
FreeContextBuffer
SecPkgContext_ClientCreds
SecPkgContext_Sizes

Condividi tramite