SOCKET_SECURITY_SETTINGS struttura (mstcpip.h)

Articolo
08/25/2023

La struttura SOCKET_SECURITY_SETTINGS specifica requisiti di sicurezza generici per un socket.

Sintassi

typedef struct _SOCKET_SECURITY_SETTINGS {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  ULONG                    SecurityFlags;
} SOCKET_SECURITY_SETTINGS;

Members

SecurityProtocol

Valore SOCKET_SECURITY_PROTOCOL che identifica il tipo di protocollo di sicurezza da usare nel socket.

SecurityFlags

Set di flag che consentono alle applicazioni di impostare requisiti di sicurezza specifici in un socket. I valori possibili sono definiti nel file di intestazione Mstcpip.h .

Valore	Significato
SOCKET_SETTINGS_GUARANTEE_ENCRYPTION 0x00000001	Indica che è necessaria la crittografia garantita del traffico. Questo flag deve essere impostato se il criterio predefinito preferisce metodi di protezione che non usano la crittografia. Se questo flag è impostato e la crittografia non è possibile per nessun motivo, non verranno inviati pacchetti e non verrà stabilita una connessione.
SOCKET_SETTINGS_ALLOW_INSECURE 0x00000002	Indica che sono consentite connessioni di testo cancellate. Se questo flag è impostato, alcuni o tutti i pacchetti inviati verranno inviati in testo chiaro, soprattutto se non è stato possibile negoziare la sicurezza con il peer. Nota Se questo flag non è impostato, è garantito che i pacchetti non verranno mai inviati in testo chiaro, anche se la negoziazione di sicurezza ha esito negativo.

Valore

Significato

SOCKET_SETTINGS_GUARANTEE_ENCRYPTION
0x00000001

Indica che è necessaria la crittografia garantita del traffico. Questo flag deve essere impostato se il criterio predefinito preferisce metodi di protezione che non usano la crittografia. Se questo flag è impostato e la crittografia non è possibile per nessun motivo, non verranno inviati pacchetti e non verrà stabilita una connessione.

SOCKET_SETTINGS_ALLOW_INSECURE
0x00000002

Indica che sono consentite connessioni di testo cancellate. Se questo flag è impostato, alcuni o tutti i pacchetti inviati verranno inviati in testo chiaro, soprattutto se non è stato possibile negoziare la sicurezza con il peer.

Nota Se questo flag non è impostato, è garantito che i pacchetti non verranno mai inviati in testo chiaro, anche se la negoziazione di sicurezza ha esito negativo.

Commenti

La struttura SOCKET_SECURITY_SETTINGS è supportata in Windows Vista e versioni successive.

La struttura SOCKET_SECURITY_SETTINGS viene usata dalla funzione WSASetSocketSecurity per abilitare e applicare la sicurezza in un socket.

Le impostazioni di sicurezza non gestite in questa struttura sono derivate dai criteri predefiniti del sistema o dai criteri configurati in modo amministrativo. È consigliabile che la maggior parte delle applicazioni specifichi un valore di SOCKET_SECURITY_PROTOCOL_DEFAULT per l'enumerazione SOCKET_SECURITY_PROTOCOL nel membro SecurityProtocol . Ciò rende l'applicazione neutrale ai protocolli di sicurezza e consente distribuzioni più semplici tra sistemi diversi.

Le applicazioni avanzate possono specificare un protocollo di sicurezza e le impostazioni associate eseguendo il cast al tipo di SOCKET_SECURITY_SETTINGS .

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	mstcpip.h

Vedi anche

SOCKET_SECURITY_PROTOCOL

Uso di estensioni socket sicure

WSASetSocketSecurity

Piattaforma filtro Windows

Funzioni API della piattaforma di filtro di Windows

Estensioni socket sicure Winsock

Condividi tramite