다음을 통해 공유


NET_ADDRESS_INFO 구조체(iphlpapi.h)

NET_ADDRESS_INFO 구조에는 ParseNetworkString 함수에서 반환된 IP 주소 정보가 포함됩니다.

구문

typedef struct NET_ADDRESS_INFO_ {
  NET_ADDRESS_FORMAT Format;
  union {
    struct {
      WCHAR Address[DNS_MAX_NAME_BUFFER_LENGTH];
      WCHAR Port[6];
    } NamedAddress;
    SOCKADDR_IN  Ipv4Address;
    SOCKADDR_IN6 Ipv6Address;
    SOCKADDR     IpAddress;
  };
} NET_ADDRESS_INFO, *PNET_ADDRESS_INFO;

멤버

Format

형식: NET_ADDRESS_FORMAT

이 구조체의 공용 구조체에 있는 네트워크 주소의 형식입니다. 이 멤버는 Iphlpapi.h 헤더 파일에 선언된 NET_ADDRESS_FORMAT 열거형의 열거형 값입니다.

NamedAddress

주소 및 포트라는 DNS입니다.

NamedAddress.Address[DNS_MAX_NAME_BUFFER_LENGTH]

형식: WCHAR[DNS_MAX_NAME_BUFFER_LENGTH]NULL로 끝나는 와이드 문자열 형식의 DNS 이름입니다. 이 문자열의 최대 길이는 Windns.h 헤더 파일에 정의된 DNS_MAX_NAME_BUFFER_LENGTH 상수입니다.

NamedAddress.Port[6]

형식: WCHAR[6]NULL로 끝나는 와이드 문자열로 형식이 지정된 네트워크 포트입니다.

Ipv4Address

형식: SOCKADDR_IN

SOCKADDR_IN 구조체로 표현되는 IPv4 주소입니다.

Ipv6Address

형식: SOCKADDR_IN6

SOCKADDR_IN6 구조체로 표현되는 IPv6 주소입니다.

IpAddress

형식: SOCKADDR

SOCKADDR 구조체로 표현되는 IPv4 또는 IPv6 주소입니다.

설명

NET_ADDRESS_INFO 구조체는 Windows Vista 이상에서 정의됩니다.

NET_ADDRESS_INFO 구조체는 ParseNetworkString 함수에 의해 반환됩니다.

SOCKADDR_IN, SOCKADDR_IN6 및 SOCKADDR 구조체는 NET_ADDRESS_INFO 구조체에 사용됩니다. SOCKADDR_IN 및 SOCKADDR 구조체는 Winsock2.h 헤더 파일에 의해 자동으로 포함되는 Ws2def.h 헤더 파일에 정의됩니다. SOCKADDR_IN6 구조는 Ws2tcpip.h 헤더 파일에 의해 자동으로 포함되는 Ws2ipdef.h 헤더 파일에 정의됩니다. NET_ADDRESS_INFO 구조를 사용하려면 Winsock2.hWs2tcpip.h 헤더 파일을 Iphlpapi.h 헤더 파일 앞에 포함해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 iphlpapi.h

참고 항목

NET_ADDRESS_FORMAT

ParseNetworkString

SOCKADDR