GetIfEntry2 함수
GetIfEntry2 함수는 로컬 컴퓨터에서 지정된 인터페이스에 대한 정보를 검색합니다.
중요하다
드라이버 개발자의 경우 NDIS OD를 서비스할 때 교착 상태를 방지하기 위해 가능한 경우 MibIfEntryNormalWithoutStatistics와 GetIfEntry2Ex 사용하는 것이 좋습니다.
통사론
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
매개 변수
-
행 [in, out]
반환에 성공하면 로컬 컴퓨터의 인터페이스에 대한 정보를 수신하는 MIB_IF_ROW2 구조체에 대한 포인터입니다. 입력 시 드라이버는 MIB_IF_ROW2 구조체의 InterfaceLuid 멤버 또는 InterfaceIndex 멤버를 인터페이스로 설정하여 정보를 검색해야 합니다.
반환 값
GetIfEntry2 함수가 성공하면 STATUS_SUCCESS 반환합니다.
함수가 실패하면 GetIfEntry2 다음 오류 코드 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
| STATUS_INVALID_PARAMETER | 잘못된 매개 변수가 함수에 전달되었습니다. NULL 포인터가 Row 매개 변수에 전달되면 이 오류가 반환됩니다. |
| STATUS_NOT_FOUND | 지정된 인터페이스를 찾을 수 없습니다. 이 오류는 함수가 Row 매개 변수가 가리키는 MIB_IF_ROW2 구조체의 InterfaceLuid 또는 InterfaceIndex 멤버로 지정된 네트워크 인터페이스를 찾을 수 없는 경우 반환됩니다. |
| 기타 | FormatMessage 함수를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다. |
발언
입력 시 드라이버는 Row 매개 변수에 전달되는 MIB_IF_ROW2 구조에서 InterfaceLuid 또는 InterfaceIndex 멤버를 초기화해야 합니다. 멤버는 이전에 나열된 순서대로 사용됩니다. 따라서 InterfaceLuid 지정된 경우 이 멤버를 사용하여 인터페이스를 확인합니다. InterfaceLuid 멤버에 대해 값이 설정되지 않은 경우(이 멤버의 값이 0으로 설정된 경우) InterfaceIndex 멤버를 사용하여 인터페이스를 확인합니다.
출력에서 Row 매개 변수가 가리키는 MIB_IF_ROW2 구조체의 나머지 필드가 채워집니다.
요구 사항
대상 플랫폼 |
유니버설 |
버전 |
Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
머리글 |
Netioapi.h(Netioapi.h 포함) |
도서관 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |