PADD_INTERFACE 콜백 함수(routprot.h)
AddInterface 함수는 라우팅 프로토콜에서 관리할 인터페이스를 추가합니다. 프로토콜은 인터페이스가 사용 안 함 상태인 것으로 간주해야 합니다. 라우터 관리자는 RIS_INTERFACE_ENABLED 플래그를 사용하여 InterfaceStatus 를 호출하여 인터페이스를 사용하도록 설정합니다.
사용자가 MprAdminInterfaceTransportAdd를 호출하면 전송에 대한 동적 인터페이스 관리자는 해당 전송과 연결된 각 라우팅 프로토콜에 대해 이 함수를 호출하는 라우터 관리자(전송용)를 호출합니다.
구문
PADD_INTERFACE PaddInterface;
DWORD PaddInterface(
[in] LPWSTR InterfaceName,
[in] ULONG InterfaceIndex,
[in] NET_INTERFACE_TYPE InterfaceType,
[in] DWORD MediaType,
[in] WORD AccessType,
[in] WORD ConnectionType,
[in] PVOID InterfaceInfo,
[in] ULONG StructureVersion,
[in] ULONG StructureSize,
[in] ULONG StructureCount
)
{...}
매개 변수
[in] InterfaceName
유니코드 문자열에 대한 포인터입니다. 문자열에는 라우터에 구성된 인터페이스 집합의 인터페이스를 고유하게 식별하는 이름이 포함되어 있습니다.
[in] InterfaceIndex
라우터에 구성된 인터페이스 집합의 인터페이스를 지정합니다.
[in] InterfaceType
인터페이스의 형식을 지정합니다.
| 값 | 의미 |
|---|---|
|
영구 연결(예: LAN, 프레임 릴레이). |
|
요청 다이얼 연결(아날로그, ISDN, PPTP, 전환된 FR). |
|
로컬 워크스테이션 연결만. |
|
원격 워크스테이션 연결만. |
[in] MediaType
나중에 사용하기 위해 예약되어 있습니다.
[in] AccessType
나중에 사용하기 위해 예약되어 있습니다.
[in] ConnectionType
나중에 사용하기 위해 예약되어 있습니다.
[in] InterfaceInfo
인터페이스와 연결된 프로토콜 정의 구성 정보를 지정하는 버퍼에 대한 포인터입니다. 이 정보는 라우팅 프로토콜에 비공개입니다.
[in] StructureVersion
InterfaceInfo 매개 변수가 가리키는 정보 구조의 버전을 지정합니다. 경우에 따라 이는 라우팅 프로토콜의 버전과 같습니다.
[in] StructureSize
InterfaceInfo 매개 변수가 가리키는 각 정보 구조의 크기를 지정합니다. 일부 정보 구조에는 가변 길이 멤버가 포함되어 있으므로 라우팅 프로토콜이 반드시 버전에서 정보의 크기를 확인할 수 있는 것은 아닙니다.
[in] StructureCount
InterfaceInfo 매개 변수가 가리키는 정보 구조의 개수를 지정합니다. 이 매개 변수는 항상 하나입니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | Description |
|---|---|
|
인터페이스를 추가하지 못했습니다. |
|
InterfaceIndex 매개 변수가 잘못되었거나(예: 해당 인덱스가 있는 인터페이스가 이미 있음) InterfaceInfo가 가리키는 매개 변수 중 하나가 잘못되었습니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | routprot.h |