Funzione SetContextAttributesA (sspi.h)

Articolo
11/20/2024

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ò essere 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 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 utilizzare 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 MTU DTLS 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 la 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 possibili codici di errore.

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

Osservazioni

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 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

Condividi tramite