PGET_INTERFACE_INFO 콜백 함수(routprot.h)
GetInterfaceInfo 함수는 특정 인터페이스에 대한 라우팅 프로토콜에 의해 유지되는 구성 정보를 가져옵니다.
구문
PGET_INTERFACE_INFO PgetInterfaceInfo;
DWORD PgetInterfaceInfo(
[in] ULONG InterfaceIndex,
[in] PVOID InterfaceInfo,
[in, out] PULONG BufferSize,
[in] PULONG StructureVersion,
[in] PULONG StructureSize,
[in] PULONG StructureCount
)
{...}
매개 변수
[in] InterfaceIndex
라우터에 구성된 인터페이스 집합의 인터페이스를 지정합니다.
[in] InterfaceInfo
인터페이스와 연결된 프로토콜 정의 구성 정보를 수신하는 버퍼에 대한 포인터입니다. 이 정보는 라우팅 프로토콜에 비공개입니다.
[in, out] BufferSize
DWORD 변수에 대한 포인터입니다.
입력 시: 이 변수는 구성 정보를 수신하기 위해 제공된 버퍼의 크기(바이트)를 지정합니다.
출력 시: 이 변수는 버퍼에 배치된 데이터의 크기(바이트)를 받습니다. 초기 크기가 충분히 크지 않은 경우 이 변수에는 모든 데이터를 보유하는 데 필요한 크기가 포함됩니다.
[in] StructureVersion
InterfaceInfo 매개 변수가 가리키는 정보 구조의 버전을 지정합니다. 경우에 따라 이는 라우팅 프로토콜의 버전과 같습니다.
[in] StructureSize
InterfaceInfo 매개 변수가 가리키는 각 정보 구조의 크기를 지정합니다. 일부 정보 구조에는 가변 길이 멤버가 포함되어 있으므로 라우팅 프로토콜이 반드시 버전에서 정보의 크기를 확인할 수 있는 것은 아닙니다.
[in] StructureCount
InterfaceInfo 매개 변수가 가리키는 정보 구조의 개수를 지정합니다. 이 매개 변수는 항상 하나입니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | Description |
|---|---|
|
정보를 검색하지 못했습니다. |
|
InterfaceIndex 매개 변수가 잘못되었거나(예: 해당 인덱스에 인터페이스가 없음) InterfaceInfoSize 매개 변수가 NULL입니다. |
|
제공된 출력 버퍼의 크기가 요청된 정보를 저장할 만큼 크지 않습니다. 필요한 크기는 InterfaceInfoSize가 가리키는 DWORD 변수에 반환됩니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | routprot.h |