struktur SOCKET_SECURITY_QUERY_TEMPLATE (mstcpip.h)

Artikel
02/29/2024

Struktur SOCKET_SECURITY_QUERY_TEMPLATE berisi templat keamanan yang digunakan oleh fungsi WSAQuerySocketSecurity .

Sintaks

typedef struct _SOCKET_SECURITY_QUERY_TEMPLATE {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE         PeerAddress;
  ULONG                    PeerTokenAccessMask;
} SOCKET_SECURITY_QUERY_TEMPLATE;

Anggota

SecurityProtocol

Nilai SOCKET_SECURITY_PROTOCOL yang mengidentifikasi protokol yang digunakan untuk mengamankan lalu lintas.

PeerAddress

Alamat IP peer yang informasi keamanannya sedang dikueri. Untuk soket berorientasi koneksi (protokol IPPROTO_TCP), soket yang terhubung secara unik mengidentifikasi serekan. Dalam hal ini, parameter ini diabaikan.

PeerTokenAccessMask

Masker akses yang digunakan untuk membuka aplikasi pengguna serekan dan handel token komputer yang dikembalikan sebagai bagian dari informasi kueri.

Keterangan

Struktur SOCKET_SECURITY_QUERY_TEMPLATE didukung pada Windows Vista dan yang lebih baru.

Struktur SOCKET_SECURITY_QUERY_TEMPLATE digunakan oleh fungsi WSAQuerySocketSecurity untuk menentukan jenis informasi kueri yang akan dikembalikan untuk soket. Struktur SOCKET_SECURITY_QUERY_TEMPLATE yang diteruskan ke fungsi WSAQuerySocketSecurity mungkin berisi nol bagi semua anggota untuk meminta informasi keamanan default.

Jika struktur SOCKET_SECURITY_QUERY_TEMPLATE ditentukan dengan anggota PeerTokenAccessMask tidak ditentukan (diatur ke nol), maka fungsi WSAQuerySocketSecurity tidak akan mengembalikan anggota PeerApplicationAccessTokenHandle dan PeerMachineAccessTokenHandle dalam struktur SOCKET_SECURITY_QUERY_INFO .

Saat ini, satu-satunya jenis protokol keamanan yang didukung adalah IPsec. Jadi menentukan nilai enumerasi SOCKET_SECURITY_PROTOCOL_DEFAULT untuk anggota SecurityProtocol memiliki efek yang sama seperti menentukan SOCKET_SECURITY_PROTOCOL_IPSEC.

Persyaratan

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