SOCKET_PEER_TARGET_NAME-Struktur (mstcpip.h)

Artikel
08/25/2023

Die SOCKET_PEER_TARGET_NAME-Struktur enthält die IP-Adresse und den Namen für ein Peerziel sowie den Typ des Sicherheitsprotokolls, das für einen Socket verwendet werden soll.

Syntax

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

Member

SecurityProtocol

Ein SOCKET_SECURITY_PROTOCOL Wert, der den Typ des Protokolls angibt, der zum Sichern des Datenverkehrs im Socket verwendet wird.

PeerAddress

Die IP-Adresse des Peers für den Socket.

PeerTargetNameStringLen

Die Länge des Peerzielnamens im AllStrings-Element in Bytes.

AllStrings[0]

Der Peerzielname für den Socket.

Hinweise

Die SOCKET_PEER_TARGET_NAME-Struktur wird unter Windows Vista und höher unterstützt.

Die SOCKET_PEER_TARGET_NAME-Struktur wird von der WSASetSocketPeerTargetName-Funktion verwendet, um den Peerzielnamen anzugeben, der einer Peer-IP-Adresse entspricht. Dieser Zielname soll von Clientanwendungen angegeben werden, um den Peer zu identifizieren, der authentifiziert werden soll.

Derzeit wird IPsec als einziger Typ von Sicherheitsprotokoll unterstützt. Die Angabe eines Enumerationswerts von SOCKET_SECURITY_PROTOCOL_DEFAULT hat also die gleiche Auswirkung wie die Angabe SOCKET_SECURITY_PROTOCOL_IPSEC im SecurityProtocol-Member .

Die Implementierung von IPsec unter Windows Vista und Windows Server 2008 unterstützt nur die Computer-zu-Computer- und Benutzer-zu-Computer-Authentifizierung. Daher sollte der Peerzielname, der im AllStrings-Member der SOCKET_PEER_TARGET_NAME-Struktur angegeben ist, auf den Peercomputerprinzipal verweisen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	mstcpip.h