InitializeIpInterfaceEntry 함수
InitializeIpInterfaceEntry 함수는 기본값을 사용하여 MIB_IPINTERFACE_ROW 구조체 항목의 멤버를 초기화합니다.
구문
VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
_Inout_ PMIB_IPINTERFACE_ROW Row
);
매개 변수
- 행 [in, out]
초기화할 MIB_IPINTERFACE_ROW 구조체에 대한 포인터입니다. 반환이 성공하면 이 매개 변수의 필드가 로컬 컴퓨터의 인터페이스에 대한 기본 정보로 초기화됩니다.
반환 값
InitializeIpInterfaceEntry 는 함수가 성공하면 STATUS_SUCCESS 반환합니다.
함수가 실패하면 InitializeIpInterfaceEntry 는 다음 오류 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_INVALID_PARAMETER | 잘못된 매개 변수가 함수에 전달되었습니다. 이 오류는 NULL 포인터가 Row 매개 변수에 전달되면 반환됩니다. |
| 기타 | FormatMessage 함수를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다. |
설명
출력에서 Row 매개 변수가 가리키는 MIB_IPINTERFACE_ROW 구조체의 멤버는 다음과 같이 초기화됩니다.
패밀리
를 AF_UNSPEC.InterfaceLuid
지정되지 않은 값으로 설정합니다.다른 모든 멤버
0으로 설정됩니다.
드라이버는 InitializeIpInterfaceEntry 함수를 사용하여 기본값으로 MIB_IPINTERFACE_ROW 구조체 항목의 필드를 초기화해야 합니다. 그런 다음 드라이버는 수정하려는 MIB_IPINTERFACE_ROW 항목의 필드를 변경한 다음 SetIpInterfaceEntry 함수를 호출할 수 있습니다.
요구 사항
대상 플랫폼 |
유니버설 |
버전 |
Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
헤더 |
Netioapi.h(Netioapi.h 포함) |
라이브러리 |
Netio.lib |
Irql |
< DISPATCH_LEVEL |