RtlIpv6AddressToStringA-Funktion (ip2string.h)

Artikel
02/01/2024

Die RtlIpv6AddressToString-Funktion konvertiert eine IPv6-Adresse in eine Zeichenfolge im Internetstandardformat.

Syntax

NTSYSAPI PSTR RtlIpv6AddressToStringA(
  [in]  const in6_addr *Addr,
  [out] PSTR           S
);

Parameter

[in] Addr

Die IPv6-Adresse in Netzwerkbytereihenfolge.

[out] S

Ein Zeiger auf einen Puffer, in dem die NULL-beendete Zeichenfolgendarstellung der IPv6-Adresse gespeichert werden soll. Dieser Puffer sollte groß genug sein, um mindestens 46 Zeichen aufzunehmen.

Rückgabewert

Ein Zeiger auf das NULL-Zeichen, das am Ende der Zeichenfolgendarstellung der IPv6-Adresse eingefügt wird. Dies kann vom Aufrufer verwendet werden, um einfach weitere Informationen an die Zeichenfolge anzufügen.

Hinweise

Die RtlIpv6AddressToString-Funktion wird verwendet, um eine IPv6-Adresse in die Zeichenfolgendarstellung der IPv6-Adresse im Internetstandardformat zu konvertieren.

Die grundlegende Zeichenfolgendarstellung besteht aus 8 hexadezimalen Zahlen, die durch Doppelpunkte getrennt sind. Eine Zeichenfolge mit aufeinanderfolgenden Nullzahlen wird durch einen Doppelpunkt ersetzt. In der Zeichenfolgendarstellung der IPv6-Adresse kann nur ein Doppelpunkt vorhanden sein. Die letzten 32 Bits werden in IPv4-Style dotted-octet notation dargestellt, wenn es sich bei der Adresse um eine IPv4-kompatible Adresse, eine IPv4-zugeordnete IPv6-Adresse oder eine ISATAP-Adresse handelt. Weitere Informationen finden Sie in Abschnitt 5 von RFC 5942 , der von der IETF veröffentlicht wurde.

RtlIpv6AddressToString ist eine Komfortfunktion, die nicht erfordert, dass die Windows Sockets-DLL geladen werden muss, um auf eine in Windows Sockets bereitgestellte Funktion zuzugreifen, um die KONVERTIERUNG von IP-Adressen in Zeichenfolgen durchzuführen.

Wenn entweder UNICODE oder _UNICODE definiert ist, wird RtlIpv6AddressToString für "RtlIpv6AddressToStringW", die Unicode-Version dieser Funktion, definiert. Der Zeichenfolgenparameter S und der Funktionsrückgabewert werden für den PWSTR-Datentyp definiert.

Wenn sowohl UNICODE als auch _UNICODE nicht definiert sind, wird RtlIpv6AddressToString für RtlIpv6AddressToStringA, die ANSI-Version dieser Funktion, definiert. Der Zeichenfolgenparameter S und der Funktionsrückgabewert werden für den PSTR-Datentyp definiert.

Die IN6_ADDR-Struktur ist in der Headerdatei In6addr.h definiert.

Eine Importbibliothek, die die Funktion RtlIpv6AddressToString enthält, ist nicht im Microsoft Windows Software Development Kit (SDK) enthalten, das für Windows Vista veröffentlicht wurde. Die RtlIpv6AddressToString-Funktion ist in der Ntdll.lib-Importbibliothek enthalten, die im Windows Driver Kit (WDK) enthalten ist. Eine Anwendung kann auch die Funktionen GetModuleHandle und GetProcAddress verwenden, um den Funktionszeiger aus dem Ntdll.dll abzurufen und diese Funktion aufzurufen.

Hinweis

Der ip2string.h-Header definiert RtlIpv6AddressToString als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	ip2string.h (include Mstcpip.h, Ip2string.h)
Bibliothek	ntdll.lib
DLL	ntdll.dll