Funzione SetContextAttributesA (sspi.h)

Articolo
08/26/2023

Consente a un'applicazione di trasporto di impostare gli attributi di un contesto di sicurezza per un pacchetto di sicurezza. Questa funzione è supportata solo dal pacchetto di sicurezza Schannel.

Sintassi

SECURITY_STATUS SEC_ENTRY SetContextAttributesA(
  [in] PCtxtHandle   phContext,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
  [in] unsigned long cbBuffer
);

Parametri

[in] phContext

Handle per il contesto di sicurezza da impostare.

[in] ulAttribute

Attributo del contesto da impostare. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
SECPKG_ATTR_APP_DATA 94	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_SessionAppData . Imposta i dati dell'applicazione per la sessione. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel.
SECPKG_ATTR_EAP_PRF_INFO 101	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_EapPrfInfo . Imposta la funzione pseudo-casuale (PRF) usata dal protocollo EAP (Extensible Authentication Protocol). Questo è il valore restituito da una chiamata alla funzione QueryContextAttributes (Schannel) quando SECPKG_ATTR_EAP_KEY_BLOCK viene passato come valore del parametro ulAttribute . Questo attributo è supportato solo dal pacchetto di sicurezza Schannel.
SECPKG_ATTR_EARLY_START 105	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_EarlyStart . Imposta la funzionalità False Start. Per informazioni su questa funzionalità, vedere il post di blog Sulla creazione di un sito Web più veloce e sicuro .
SECPKG_ATTR_DTLS_MTU 34	Imposta e recupera il valore MTU (unità di trasmissione massima) da usare con DTLS. Se DTLS non è abilitato in un contesto di sicurezza, questo attributo non è supportato. I valori validi sono compresi tra 200 byte e 64 kilobyte. Il valore predefinito di DTLS MTU in Schannel è 1096 byte.
SECPKG_ATTR_KEYING_MATERIAL_INFO 106	Il parametro pBuffer contiene un puntatore a una struttura SecPkgContext_KeyingMaterialInfo . La funzionalità di esportazione dei materiali di keying segue lo standard RFC 5705. Questo attributo è supportato solo dal pacchetto di sicurezza Schannel in Windows 10 e Windows Server 2016 o versioni successive.

[in] pBuffer

Puntatore a una struttura che contiene valori su cui impostare gli attributi. Il tipo di struttura a cui punta dipende dal valore specificato nel parametro ulAttribute .

[in] cbBuffer

Dimensione, in byte, del parametro pBuffer .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce SEC_E_OK.

Se la funzione ha esito negativo, restituisce un codice di errore diverso da zero. Il codice di errore seguente è uno dei codici di errore possibili.

Codice restituito	Descrizione
SEC_E_UNSUPPORTED_FUNCTION	Questo valore viene restituito dalla modalità kernel Schannel per indicare che questa funzione non è supportata.

Commenti

Nota

L'intestazione sspi.h definisce SetContextAttributes 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	sspi.h (include Security.h)
Libreria	Secur32.lib
DLL	Secur32.dll