struktur SOCKET_PEER_TARGET_NAME (mstcpip.h)

Artikel
02/29/2024

Struktur SOCKET_PEER_TARGET_NAME berisi alamat IP dan nama untuk target serekan dan jenis protokol keamanan yang akan digunakan pada soket.

Sintaks

typedef struct _SOCKET_PEER_TARGET_NAME {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE         PeerAddress;
  ULONG                    PeerTargetNameStringLen;
  wchar_t                  AllStrings[0];
} SOCKET_PEER_TARGET_NAME;

Anggota

SecurityProtocol

Nilai SOCKET_SECURITY_PROTOCOL yang mengidentifikasi jenis protokol yang digunakan untuk mengamankan lalu lintas pada soket.

PeerAddress

Alamat IP peer untuk soket.

PeerTargetNameStringLen

Panjangnya, dalam byte, dari nama target serekan di anggota AllStrings .

AllStrings[0]

Nama target serekan untuk soket.

Keterangan

Struktur SOCKET_PEER_TARGET_NAME didukung pada Windows Vista dan yang lebih baru.

Struktur SOCKET_PEER_TARGET_NAME digunakan oleh fungsi WSASetSocketPeerTargetName untuk menentukan nama target peer yang sesuai dengan alamat IP serekan. Nama target ini dimaksudkan untuk ditentukan oleh aplikasi klien untuk mengidentifikasi serekan yang harus diautentikasi dengan aman.

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

Implementasi IPsec pada Windows Vista dan Windows Server 2008 hanya mendukung autentikasi komputer-ke-komputer dan pengguna-ke-komputer. Akibatnya, nama target serekan yang ditentukan dalam anggota AllStrings dari struktur SOCKET_PEER_TARGET_NAME harus merujuk ke prinsip komputer serekan.

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