Share via


RtlIpv4AddressToString (Compact 7)

3/12/2014

This function converts an IPv4 address to a string in Internet standard dotted-decimal format.

Syntax

LPTSTR NTAPI RtlIpv4AddressToString(
  __in   const IN_ADDR* Addr,
  __out  LPTSTR S
);

Parameters

  • Addr
    The IPv4 address in network byte order.
  • S
    A pointer to a buffer in which to store the NULL-terminated string representation of the IPv4 address. This buffer should be large enough to hold at least 16 characters.

Return Value

A pointer to the NULL character inserted at the end of the string representation of the IPv4 address. This can be used by the caller to easily append more information to the string.

Remarks

The RtlIpv4AddressToString function is used to convert an IPv4 address to the string representation of the IPv4 address in Internet dotted-decimal format.

RtlIpv4AddressToString 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 IP address to string conversion.

When UNICODE or _UNICODE is defined, RtlIpv4AddressToString is defined to RtlIpv4AddressToStringW, the Unicode version of this function. The string parameters are defined to the PWSTR data type.

When UNICODE or _UNICODE is not defined, RtlIpv4AddressToString is defined to RtlIpv4AddressToStringA, the ANSI version of this function. The string parameters are defined to the PSTR data type.

The IN_ADDR structure is defined in the Inaddr.h header file.

See Also

Reference

IP Helper Functions
RtlIpv4AddressToStringEx
RtlIpv4StringToAddress
RtlIpv4StringToAddressEx
RtlIpv6AddressToString
RtlIpv6AddressToStringEx
RtlIpv6StringToAddress
RtlIpv6StringToAddressEx

Other Resources

GetProcAddress
LoadLibrary