GetIfTable 함수(iphlpapi.h)
GetIfTable 함수는 MIB-II 인터페이스 테이블을 검색합니다.
구문
IPHLPAPI_DLL_LINKAGE DWORD GetIfTable(
[out] PMIB_IFTABLE pIfTable,
[in, out] PULONG pdwSize,
[in] BOOL bOrder
);
매개 변수
[out] pIfTable
인터페이스 테이블을 MIB_IFTABLE 구조체로 수신하는 버퍼에 대한 포인터입니다.
[in, out] pdwSize
입력 시 pIfTable 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정합니다.
출력에서 버퍼가 반환된 인터페이스 테이블을 보유할 만큼 충분히 크지 않은 경우 함수는 이 매개 변수를 필요한 버퍼 크기(바이트)와 동일하게 설정합니다.
[in] bOrder
반환된 인터페이스 테이블을 인터페이스 인덱스별로 오름차순으로 정렬할지 여부를 지정하는 부울 값입니다. 이 매개 변수가 TRUE이면 테이블이 정렬됩니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 반환 코드 | 설명 |
|---|---|
|
pIfTable 매개 변수가 가리키는 버퍼가 충분히 크지 않습니다. 필요한 크기는 pdwSize 매개 변수가 가리키는 DWORD 변수에 반환됩니다. |
|
pdwSize 매개 변수가 NULL이거나 GetIfTable이 pdwSize 매개 변수가 가리키는 메모리에 쓸 수 없습니다. |
|
이 함수는 로컬 시스템에서 사용 중인 운영 체제에서 지원되지 않습니다. |
|
FormatMessage 함수를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다. |
설명
The
GetIfTable 함수는 로컬 시스템의 물리적 인터페이스를 열거하고 이 정보를 MIB_IFTABLE 구조로 반환합니다. 물리적 인터페이스에는 소프트웨어 루프백 인터페이스가 포함됩니다.
Windows Vista 이상에서 사용할 수 있는 GetIfTable2 및 GetIfTable2Ex 함수는 로컬 시스템의 물리적 인터페이스와 논리 인터페이스를 모두 열거하는 GetIfTable 함수의 향상된 버전입니다. 논리 인터페이스에는 L2TP, PPTP, PPOE 및 기타 터널 캡슐화에 사용되는 다양한 WAN 미니포트 인터페이스가 포함됩니다.
인터페이스는 pIfTable 매개 변수가 가리키는 버퍼의 MIB_IFTABLE 구조로 반환됩니다. MIB_IFTABLE 구조에는 인터페이스 수와 각 인터페이스에 대한 MIB_IFROW 구조의 배열이 포함됩니다.
pIfTable 매개 변수가 가리키는 반환된 MIB_IFTABLE 구조체에는 dwNumEntries 멤버와 MIB_IFTABLE 구조체의 테이블 멤버에 있는 첫 번째 MIB_IFROW 배열 항목 간의 맞춤을 위한 안쪽 여백이 포함될 수 있습니다. 정렬을 위한 안쪽 여백은 MIB_IFROW 배열 항목 사이에도 있을 수 있습니다. MIB_IFROW 배열 항목에 대한 액세스는 패딩이 있을 수 있다고 가정해야 합니다.
예제
다음 예제에서는 인터페이스 테이블을 검색하고 테이블의 항목 수와 각 항목에 대한 일부 데이터를 출력합니다.
#include <winsock2.h>
#include <ws2tcpip.h>
#pragma comment(lib, "IPHLPAPI.lib")
#include <iphlpapi.h>
#include <stdio.h>
#include <stdlib.h>
#define MALLOC(x) HeapAlloc(GetProcessHeap(), 0, (x))
#define FREE(x) HeapFree(GetProcessHeap(), 0, (x))
/* Note: could also use malloc() and free() */
int main()
{
// Declare and initialize variables.
DWORD dwSize = 0;
DWORD dwRetVal = 0;
unsigned int i, j;
/* variables used for GetIfTable and GetIfEntry */
MIB_IFTABLE *pIfTable;
MIB_IFROW *pIfRow;
// Allocate memory for our pointers.
pIfTable = (MIB_IFTABLE *) MALLOC(sizeof (MIB_IFTABLE));
if (pIfTable == NULL) {
printf("Error allocating memory needed to call GetIfTable\n");
return 1;
}
// Make an initial call to GetIfTable to get the
// necessary size into dwSize
dwSize = sizeof (MIB_IFTABLE);
if (GetIfTable(pIfTable, &dwSize, FALSE) == ERROR_INSUFFICIENT_BUFFER) {
FREE(pIfTable);
pIfTable = (MIB_IFTABLE *) MALLOC(dwSize);
if (pIfTable == NULL) {
printf("Error allocating memory needed to call GetIfTable\n");
return 1;
}
}
// Make a second call to GetIfTable to get the actual
// data we want.
if ((dwRetVal = GetIfTable(pIfTable, &dwSize, FALSE)) == NO_ERROR) {
printf("\tNum Entries: %ld\n\n", pIfTable->dwNumEntries);
for (i = 0; i < pIfTable->dwNumEntries; i++) {
pIfRow = (MIB_IFROW *) & pIfTable->table[i];
printf("\tIndex[%d]:\t %ld\n", i, pIfRow->dwIndex);
printf("\tInterfaceName[%d]:\t %ws", i, pIfRow->wszName);
printf("\n");
printf("\tDescription[%d]:\t ", i);
for (j = 0; j < pIfRow->dwDescrLen; j++)
printf("%c", pIfRow->bDescr[j]);
printf("\n");
printf("\tType[%d]:\t ", i);
switch (pIfRow->dwType) {
case IF_TYPE_OTHER:
printf("Other\n");
break;
case IF_TYPE_ETHERNET_CSMACD:
printf("Ethernet\n");
break;
case IF_TYPE_ISO88025_TOKENRING:
printf("Token Ring\n");
break;
case IF_TYPE_PPP:
printf("PPP\n");
break;
case IF_TYPE_SOFTWARE_LOOPBACK:
printf("Software Lookback\n");
break;
case IF_TYPE_ATM:
printf("ATM\n");
break;
case IF_TYPE_IEEE80211:
printf("IEEE 802.11 Wireless\n");
break;
case IF_TYPE_TUNNEL:
printf("Tunnel type encapsulation\n");
break;
case IF_TYPE_IEEE1394:
printf("IEEE 1394 Firewire\n");
break;
default:
printf("Unknown type %ld\n", pIfRow->dwType);
break;
}
printf("\tMtu[%d]:\t\t %ld\n", i, pIfRow->dwMtu);
printf("\tSpeed[%d]:\t %ld\n", i, pIfRow->dwSpeed);
printf("\tPhysical Addr:\t ");
if (pIfRow->dwPhysAddrLen == 0)
printf("\n");
for (j = 0; j < pIfRow->dwPhysAddrLen; j++) {
if (j == (pIfRow->dwPhysAddrLen - 1))
printf("%.2X\n", (int) pIfRow->bPhysAddr[j]);
else
printf("%.2X-", (int) pIfRow->bPhysAddr[j]);
}
printf("\tAdmin Status[%d]:\t %ld\n", i, pIfRow->dwAdminStatus);
printf("\tOper Status[%d]:\t ", i);
switch (pIfRow->dwOperStatus) {
case IF_OPER_STATUS_NON_OPERATIONAL:
printf("Non Operational\n");
break;
case IF_OPER_STATUS_UNREACHABLE:
printf("Unreachable\n");
break;
case IF_OPER_STATUS_DISCONNECTED:
printf("Disconnected\n");
break;
case IF_OPER_STATUS_CONNECTING:
printf("Connecting\n");
break;
case IF_OPER_STATUS_CONNECTED:
printf("Connected\n");
break;
case IF_OPER_STATUS_OPERATIONAL:
printf("Operational\n");
break;
default:
printf("Unknown status %ld\n", pIfRow->dwAdminStatus);
break;
}
printf("\n");
}
} else {
printf("GetIfTable failed with error: \n", dwRetVal);
if (pIfTable != NULL) {
FREE(pIfTable);
pIfTable = NULL;
}
return 1;
// Here you can use FormatMessage to find out why
// it failed.
}
if (pIfTable != NULL) {
FREE(pIfTable);
pIfTable = NULL;
}
return 0;
}
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | iphlpapi.h |
| 라이브러리 | Iphlpapi.lib |
| DLL | Iphlpapi.dll |