RtlIpv6AddressToStringA-Funktion (ip2string.h)
Die funktion RtlIpv6AddressToString 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 lang zu halten.
Rückgabewert
Ein Zeiger auf das NULL-Zeichen, das am Ende der Zeichenfolgendarstellung der IPv6-Adresse eingefügt wurde. Dies kann vom Aufrufer verwendet werden, um problemlos weitere Informationen an die Zeichenfolge anzufügen.
Bemerkungen
Die funktion RtlIpv6AddressToString 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 aufeinander folgender Nullnummern wird durch einen Doppelpunkt ersetzt. In der Zeichenfolgendarstellung der IPv6-Adresse kann nur ein Doppelpunkt vorhanden sein. Die letzten 32 Bits werden in der IPv4-Schreibweise punktierte Oktettnotation 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 veröffentlicht vom IETF.
RtlIpv6AddressToString ist eine Komfortfunktion, die nicht erfordert, dass die Windows Sockets-DLL geladen wird, um auf eine in Windows Sockets bereitgestellte Funktion zuzugreifen, um IP-Adresse für die Zeichenfolgenkonvertierung auszuführen.
Wenn unicode oder _UNICODE definiert ist, wird RtlIpv6AddressToString- für RtlIpv6AddressToStringWdefiniert, die Unicode-Version dieser Funktion. Der Zeichenfolgenparameter S und der Rückgabewert der Funktion werden für den PWSTR-Datentyp definiert.
Wenn unicode und _UNICODE nicht definiert sind, wird RtlIpv6AddressToString- für RtlIpv6AddressToStringAdefiniert, die ANSI-Version dieser Funktion. Der Zeichenfolgenparameter S und der Rückgabewert der Funktion werden für den PSTR-Datentyp definiert.
Die IN6_ADDR Struktur wird in der In6addr.h Headerdatei definiert.
Eine Importbibliothek, die die RtlIpv6AddressToString--Funktion enthält, ist nicht im für Windows Vista veröffentlichten Microsoft Windows Software Development Kit (SDK) enthalten. Die funktion RtlIpv6AddressToString ist in der Ntdll.lib Importbibliothek enthalten, die im Windows Driver Kit (WDK) enthalten ist. Eine Anwendung kann auch die GetModuleHandle- und GetProcAddress- Funktionen verwenden, um den Funktionszeiger aus dem Ntdll.dll abzurufen und diese Funktion aufzurufen.
Anmerkung
Der header ip2string.h 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 Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | ip2string.h (include Mstcpip.h, Ip2string.h) |
| Library | ntdll.lib |
| DLL- | ntdll.dll |