Freigeben über


WTS_CLIENT_ADDRESS-Struktur (wtsapi32.h)

Enthält die Clientnetzwerkadresse einer Remotedesktopdienste-Sitzung.

Syntax

typedef struct _WTS_CLIENT_ADDRESS {
  DWORD AddressFamily;
  BYTE  Address[20];
} WTS_CLIENT_ADDRESS, *PWTS_CLIENT_ADDRESS;

Member

AddressFamily

Adressfamilie. Dieses Element kann AF_INET, AF_INET6, AF_IPX, AF_NETBIOS oder AF_UNSPEC sein.

Address[20]

Clientnetzwerkadresse. Das Format des Felds "Adresse " hängt vom Adresstyp ab, der vom AddressFamily-Element angegeben wird.

Für eine Adressfamilie AF_INET: Address enthält die IPV4-Adresse des Clients als unformatierte Bytewerte. Die IP-Adresse wird vom Anfang des Adresselements um zwei Bytes versetzt. Beispielsweise wird die Adresse 192.168.0.1 als folgende Bytewertreihe dargestellt: "0x00 0x00 0xC0 0xA8 0x00 0x01".

Für eine Familie AF_INET6: Address enthält die IPV6-Adresse des Clients als unformatierte Bytewerte. (Beispielsweise würde die Adresse "FFFF::1" als folgende Bytewertreihe dargestellt: "0xFF 0xFF 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x01")

Hinweise

Die Clientnetzwerkadresse wird vom RDP-Client selbst gemeldet, wenn er eine Verbindung mit dem Server herstellt. Dies kann sich von der Adresse unterscheiden, die tatsächlich mit dem Server verbunden ist. Angenommen, es gibt eine NAT zwischen dem Client und dem Server. Der Client kann seine eigene IP-Adresse melden, aber die IP-Adresse, die tatsächlich eine Verbindung mit dem Server herstellt, ist die NAT-Adresse. Bei VPN-Verbindungen kann die IP-Adresse vom Client möglicherweise nicht ermittelt werden. Wenn es nicht ermittelt werden kann, kann der Client die einzige IP-Adresse melden, die er besitzt, wobei es sich um die vom ISP zugewiesene Adresse handeln kann. Da die Adresse möglicherweise nicht die tatsächliche Netzwerkadresse ist, sollte sie nicht als Form der Clientauthentifizierung verwendet werden.

Die Clientnetzwerkadresse ist auch in den folgenden Fällen nicht verfügbar:

  • Die Verbindung wird über ein Remotedesktopgateway hergestellt.
  • Die Verbindung wird von der Microsoft-Remotedesktop-App hergestellt, die im Store verfügbar ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Kopfzeile wtsapi32.h

Weitere Informationen

WTSQuerySessionInformation