GetIfEntry2Ex 함수(netioapi.h)

아티클
02/29/2024

GetIfEntry2Ex 함수는 로컬 컴퓨터에서 지정된 인터페이스에 대해 지정된 수준의 정보를 검색합니다.

구문

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfEntry2Ex(
  [in]      MIB_IF_ENTRY_LEVEL Level,
  [in, out] PMIB_IF_ROW2       Row
);

매개 변수

[in] Level

검색할 인터페이스 정보의 수준입니다. 이 매개 변수는 Netioapi.h 헤더 파일에 정의된 MIB_IF_ENTRY_LEVEL 열거형 형식의 값 중 하나일 수 있습니다.

값	의미
MibIfEntryNormal 0	Row 매개 변수가 가리키는 MIB_IF_ROW2 구조체의 멤버에서 반환된 통계 및 상태 값은 필터 스택의 맨 위에서 반환됩니다.
MibIfEntryNormalWithoutStatistics 2	Row 매개 변수가 가리키는 MIB_IF_ROW2 구조체의 멤버에서 반환된 상태 값(통계 없음)은 필터 스택의 맨 위에서 반환됩니다.

[in, out] Row

성공적으로 반환될 때 로컬 컴퓨터의 인터페이스에 대한 정보를 수신하는 MIB_IF_ROW2 구조체에 대한 포인터입니다. 입력 시 MIB_IF_ROW2InterfaceLuid 또는 InterfaceIndex 멤버를 정보를 검색할 인터페이스로 설정해야 합니다.

반환 값

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

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드	설명
ERROR_FILE_NOT_FOUND	시스템은 지정된 파일을 찾을 수 없습니다. Row 매개 변수가 가리키는 MIB_IF_ROW2InterfaceLuid 또는 InterfaceIndex 멤버가 지정한 네트워크 인터페이스 LUID 또는 인터페이스 인덱스가 로컬 컴퓨터의 값이 아닌 경우 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	잘못된 매개 변수가 함수에 전달되었습니다. 이 오류는 NULL 매개 변수가 Row 매개 변수에 전달되면 반환됩니다. Row 매개 변수가 가리키는 MIB_IF_ROW2InterfaceLuid 및 InterfaceIndex 멤버가 모두 지정되지 않은 경우에도 이 오류가 반환됩니다.
기타	FormatMessage 함수를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

The
GetIfEntry2Ex 함수는 로컬 시스템의 지정된 인터페이스에 대한 정보를 검색하고 이 정보를 에 대한 포인터로 반환합니다.
MIB_IF_ROW2 구조체입니다. GetIfEntry2Ex 는 검색할 인터페이스 정보의 수준을 선택할 수 있는 GetIfEntry2 함수의 향상된 버전입니다.

입력 시 Row 매개 변수에 전달된 MIB_IF_ROW2 구조체의 다음 멤버 중 하나 이상을 초기화해야 합니다. InterfaceLuid 또는 InterfaceIndex.

필드는 위에 나열된 순서대로 사용됩니다. 따라서 InterfaceLuid 가 지정된 경우 이 멤버를 사용하여 인터페이스를 확인합니다. InterfaceLuid 멤버에 대해 값이 설정되지 않은 경우(이 멤버의 값이 0으로 설정됨) InterfaceIndex 멤버를 사용하여 인터페이스를 확인합니다.

출력에서 Row 매개 변수가 가리키는 MIB_IF_ROW2 구조체의 나머지 필드가 채워집니다.

Netioapi.h 헤더 파일은 Iphlpapi.h 헤더 파일에 자동으로 포함되며 직접 사용하면 안 됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1703 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	netioapi.h(Iphlpapi.h 포함)
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll