RtlIpv6StringToAddressEx (Compact 7)
3/12/2014
This function converts a string representation of an IPv6 address, scope ID, and port number to a binary IPv6 address, scope ID, and port.
Syntax
LONG NTAPI RtlIpv6StringToAddressEx(
__in PCTSTR AddressString,
__out IN6_ADDR* Address,
__out PULONG ScopeId,
__in PUSHORT Port
);
Parameters
- AddressString
A pointer to a buffer that contains the NULL-terminated string representation of the IPv6 address, scope ID, and port number.
- Address
A pointer where the binary representation of the IPv6 address is to be stored.
- ScopeId
A pointer to where scope ID of the IPv6 address is stored. If AddressString parameter does not contain the string representation of a scope ID, zero is returned in this parameter.
- Port
A pointer where the port number is stored. The port number is in network byte order format. If AddressString parameter does not contain the string representation of a port number, zero is returned in this parameter.
Return Value
| Return code | Description |
|---|---|
NO_ERROR |
The function succeeds. |
ERROR_INVALID_PARAMETER |
An invalid parameter was passed to the function. This error is returned if the string that was passed in the AddressString parameter did not contain a proper string representation of an IPv6 address. |
Other |
Use FormatMessage to obtain the message string for the returned error. |
Remarks
The RtlIpv6StringToAddressEx function is used to convert a string representation of the IPv6 address, scope ID, and port number to a binary IPv6 address, scope ID, and port number. The IPv6 address is returned in network order (bytes ordered from left to right). The port number and scope ID are returned in network order.
RtlIpv6StringToAddressEx is a convenience function that does not require that the Windows Sockets DLL be loaded to access a function that is provided in Windows Sockets to perform string to IP address conversion.
The string pointed to by the AddressString parameter must be represented in the form for an IPv6 address string followed by an optional percent character and scope ID string. The IPv6 address and scope ID string must be enclosed in square brackets. The right square bracket after the IPv6 address and scope ID string may be followed by an optional colon and a string representation of a port number. The basic string representation of an IPv6 address consists of 8 hexadecimal numbers separated by colons. A string of consecutive zero numbers may be replaced with a double-colon. There can only be one double-colon in the string representation of the IPv6 address. The last 32 bits may be represented in IPv4-style dotted-octet notation if the address is a IPv4-compatible address.
When UNICODE or _UNICODE is defined, RtlIpv6StringToAddressEx is defined to RtlIpv6StringToAddressExW, the Unicode version of this function. The AddressString parameter is defined to the PCWSTR data type.
When UNICODE or _UNICODE is not defined, RtlIpv6StringToAddressEx is defined to RtlIpv6StringToAddressExA, the ANSI version of this function. The AddressString parameter is defined to the PCSTR data type.
The IN6_ADDR structure is defined in the Inaddr.h header file.
See Also
Reference
IP Helper Functions
RtlIpv4AddressToString
RtlIpv4AddressToStringEx
RtlIpv4StringToAddress
RtlIpv4StringToAddressEx
RtlIpv6AddressToString
RtlIpv6AddressToStringEx
RtlIpv6StringToAddress