GetIpNetTable 함수(iphlpapi.h)

아티클
02/28/2024

GetIpNetTable 함수는 IPv4에서 실제 주소 매핑 테이블을 검색합니다.

구문

IPHLPAPI_DLL_LINKAGE ULONG GetIpNetTable(
  [out]     PMIB_IPNETTABLE IpNetTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

매개 변수

[out] IpNetTable

IPv4에서 실제 주소 매핑 테이블을 MIB_IPNETTABLE 구조로 수신하는 버퍼에 대한 포인터입니다.

[in, out] SizePointer

입력 시 pIpNetTable 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정합니다.

출력에서 버퍼가 반환된 매핑 테이블을 보유할 만큼 크지 않은 경우 함수는 이 매개 변수를 필요한 버퍼 크기(바이트)와 동일하게 설정합니다.

[in] Order

반환된 매핑 테이블을 IP 주소별로 오름차순으로 정렬할지 여부를 지정하는 부울 값입니다. 이 매개 변수가 TRUE이면 테이블이 정렬됩니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR 또는 ERROR_NO_DATA.

함수가 실패하거나 데이터를 반환하지 않는 경우 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드	설명
ERROR_INSUFFICIENT_BUFFER	pIpNetTable 매개 변수가 가리키는 버퍼가 충분히 크지 않습니다. pdwSize 매개 변수가 가리키는 DWORD 변수에 필요한 크기가 반환됩니다.
ERROR_INVALID_PARAMETER	잘못된 매개 변수가 함수에 전달되었습니다. pdwSize 매개 변수가 NULL이거나 GetIpNetTable이 pdwSize 매개 변수가 가리키는 메모리에 쓸 수 없는 경우 이 오류가 반환됩니다.
ERROR_NO_DATA	반환할 데이터가 없습니다. IPv4에서 실제 주소 매핑 테이블이 비어 있습니다. 이 반환 값은 GetIpNetTable 함수에 대한 호출이 성공했지만 반환할 데이터가 없음을 나타냅니다.
ERROR_NOT_SUPPORTED	IPv4 전송이 로컬 컴퓨터에 구성되지 않았습니다.
기타	FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

The
GetIpNetTable 함수는 IPv4에서 실제 주소 매핑 테이블로 로컬 시스템의 IPv4에 대한 ARP(주소 확인 프로토콜) 항목을 열거하고 이 정보를 MIB_IPNETTABLE 구조로 반환합니다.

IPv4 주소 항목은 pIpNetTable 매개 변수가 가리키는 버퍼의 MIB_IPNETTABLE 구조로 반환됩니다. MIB_IPNETTABLE 구조체에는 각 IPv4 주소 항목에 대한 ARP 항목 수와 MIB_IPNETROW 구조 배열이 포함됩니다.

pIpNetTable 매개 변수가 가리키는 반환된 MIB_IPNETTABLE 구조체에는 dwNumEntries 멤버와 MIB_IPNETTABLE 구조체의 테이블 멤버에 있는 첫 번째 MIB_IPNETROW 배열 항목 간의 맞춤을 위한 패딩이 포함될 수 있습니다. 정렬을 위한 안쪽 여백은 MIB_IPNETROW 배열 항목 사이에도 있을 수 있습니다. MIB_IPNETROW 배열 항목에 대한 액세스는 패딩이 있을 수 있다고 가정해야 합니다.

Windows Vista 이상에서는 GetIpNetTable2 함수를 사용하여 IPv6 및 IPv4 모두에 대한 인접 IP 주소를 검색할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	iphlpapi.h
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll