struktur SOCKET_SECURITY_SETTINGS (mstcpip.h)

Artikel
08/25/2023

Struktur SOCKET_SECURITY_SETTINGS menentukan persyaratan keamanan generik untuk soket.

Sintaks

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

Anggota

SecurityProtocol

Nilai SOCKET_SECURITY_PROTOCOL yang mengidentifikasi jenis protokol keamanan yang akan digunakan pada soket.

SecurityFlags

Sekumpulan bendera yang memungkinkan aplikasi untuk mengatur persyaratan keamanan tertentu pada soket. Nilai yang mungkin ditentukan dalam file header Mstcpip.h .

Nilai	Makna
SOCKET_SETTINGS_GUARANTEE_ENCRYPTION 0x00000001	Menunjukkan bahwa enkripsi lalu lintas yang dijamin diperlukan. Bendera ini harus diatur jika kebijakan default lebih memilih metode perlindungan yang tidak menggunakan enkripsi. Jika bendera ini diatur dan enkripsi tidak dimungkinkan karena alasan apa pun, tidak ada paket yang akan dikirim dan koneksi tidak akan dibuat.
SOCKET_SETTINGS_ALLOW_INSECURE 0x00000002	Menunjukkan bahwa koneksi teks yang jelas diizinkan. Jika bendera ini diatur, beberapa atau semua paket yang dikirim akan dikirim dalam teks yang jelas, terutama jika keamanan dengan serekan tidak dapat dinegosiasikan. Catatan Jika bendera ini tidak diatur, dijamin bahwa paket tidak akan pernah dikirim dalam teks yang jelas, bahkan jika negosiasi keamanan gagal.

Keterangan

Struktur SOCKET_SECURITY_SETTINGS didukung pada Windows Vista dan yang lebih baru.

Struktur SOCKET_SECURITY_SETTINGS digunakan oleh fungsi WSASetSocketSecurity untuk mengaktifkan dan menerapkan keamanan pada soket.

Pengaturan keamanan yang tidak ditangani dalam struktur ini berasal dari kebijakan default sistem atau kebijakan yang dikonfigurasi secara administratif. Disarankan agar sebagian besar aplikasi menentukan nilai SOCKET_SECURITY_PROTOCOL_DEFAULT untuk enumerasi SOCKET_SECURITY_PROTOCOL di anggota SecurityProtocol . Ini membuat aplikasi netral terhadap protokol keamanan dan memungkinkan penyebaran yang lebih mudah di antara sistem yang berbeda.

Aplikasi tingkat lanjut dapat menentukan protokol keamanan dan pengaturan terkait dengan mentransmisikannya ke jenis SOCKET_SECURITY_SETTINGS .

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	mstcpip.h