SOCKET_SECURITY_QUERY_TEMPLATE-Struktur (mstcpip.h)

Artikel
02/29/2024

Die SOCKET_SECURITY_QUERY_TEMPLATE-Struktur enthält die Sicherheitsvorlage, die von der WSAQuerySocketSecurity-Funktion verwendet wird.

Syntax

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

Member

SecurityProtocol

Ein SOCKET_SECURITY_PROTOCOL Wert, der das Protokoll identifiziert, das zum Sichern des Datenverkehrs verwendet wird.

PeerAddress

Die IP-Adresse des Peers, für den Sicherheitsinformationen abgefragt werden. Bei verbindungsorientierten Sockets (Protokoll der IPPROTO_TCP) identifiziert der verbundene Socket einen Peer eindeutig. In diesem Fall wird dieser Parameter ignoriert.

PeerTokenAccessMask

Die Zugriffsmaske, die zum Öffnen der Peerbenutzeranwendung und der Computertokenhandles verwendet wird, die als Teil der Abfrageinformationen zurückgegeben werden.

Hinweise

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

Die SOCKET_SECURITY_QUERY_TEMPLATE-Struktur wird von der WSAQuerySocketSecurity-Funktion verwendet, um den Typ der Abfrageinformationen anzugeben, die für einen Socket zurückgegeben werden sollen. Die an die WSAQuerySocketSecurity-Funktion übergebene SOCKET_SECURITY_QUERY_TEMPLATE-Struktur kann Nullen für alle Member zum Anfordern von Standardsicherheitsinformationen enthalten.

Wenn die SOCKET_SECURITY_QUERY_TEMPLATE-Struktur mit dem PeerTokenAccessMask-Element angegeben ist, das nicht angegeben ist (auf Null festgelegt), gibt die WSAQuerySocketSecurity-Funktion die Elemente PeerApplicationAccessTokenHandle und PeerMachineAccessTokenHandle in der SOCKET_SECURITY_QUERY_INFO-Struktur nicht zurück.

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

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