SOCKET_SECURITY_QUERY_INFO-Struktur (mstcpip.h)

Artikel
08/25/2023

Die SOCKET_SECURITY_QUERY_INFO-Struktur enthält Sicherheitsinformationen, die von der WSAQuerySocketSecurity-Funktion zurückgegeben werden.

Syntax

typedef struct _SOCKET_SECURITY_QUERY_INFO {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  ULONG                    Flags;
  UINT64                   PeerApplicationAccessTokenHandle;
  UINT64                   PeerMachineAccessTokenHandle;
} SOCKET_SECURITY_QUERY_INFO;

Members

SecurityProtocol

Ein SOCKET_SECURITY_PROTOCOL Wert, der das Protokoll identifiziert, das zum Schützen des Datenverkehrs verwendet wird.

Flags

Der Satz möglicher Sicherheitsflags für die in der Headerdatei Mstcpip.h definierte Verbindung.

Wert	Bedeutung
SOCKET_INFO_CONNECTION_SECURED 0x00000001	Falls vorhanden, wird der Datenverkehr durch ein Sicherheitsprotokoll gesichert. Wenn er nicht vorhanden ist, fließt der Datenverkehr in der Klarsicht.
SOCKET_INFO_CONNECTION_ENCRYPTED 0x00000002	Falls vorhanden, wird der Verbindungsdatenverkehr verschlüsselt. Das SOCKET_INFO_CONNECTION_SECURED-Flag wird immer festgelegt, wenn dieses Flag vorhanden ist.

PeerApplicationAccessTokenHandle

Ein Handle für das Zugriffstoken, das das Konto darstellt, unter dem die Peeranwendung ausgeführt wird. Nach der Verwendung des Tokens für Zugriffsprüfungen sollte die Anwendung das Handle mit der CloseHandle-Funktion schließen.

PeerMachineAccessTokenHandle

Ein Handle für das Zugriffstoken für das Konto des Peercomputers im Verlauf der Anwendung. Nach der Verwendung des Tokens für Zugriffsprüfungen sollte die Anwendung das Handle mit der CloseHandle-Funktion schließen.

Hinweise

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

Die SOCKET_SECURITY_QUERY_INFO-Struktur wird von der WSAQuerySocketSecurity-Funktion verwendet, um Informationen zur Sicherheit zurückzugeben, die auf eine Verbindung in einem Socket angewendet wird.

Anforderungen


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