PINTERFACE_STATUS 콜백 함수(routprot.h)

라우터 관리자는 InterfaceStatus 함수를 호출하여 인터페이스의 상태 변경합니다.

PINTERFACE_STATUS 형식은 이 콜백 함수에 대한 포인터를 정의합니다. InterfaceStatus 는 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

PINTERFACE_STATUS PinterfaceStatus;

DWORD PinterfaceStatus(
  [in] ULONG InterfaceIndex,
  [in] BOOL InterfaceActive,
  [in] DWORD StatusType,
  [in] PVOID StatusInfo
)
{...}

매개 변수

[in] InterfaceIndex

변경할 인터페이스의 인덱스를 지정합니다.

[in] InterfaceActive

인터페이스가 활성 상태인지 여부를 지정합니다.

[in] StatusType

새 인터페이스 상태 지정합니다. 이 매개 변수는 다음 값 중 하나입니다.

RIS_INTERFACE_ADDRESS_CHANGE

RIS_INTERFACE_ENABLED

RIS_INTERFACE_DISABLED

RIS_INTERFACE_MEDIA_PRESENT

RIS_INTERFACE_MEDIA_ABSENT

[in] StatusInfo

인터페이스 상태 형식의 형식에 적합한 정보를 지정하는 구조체에 대한 포인터입니다. 예를 들어 StatusType 매개 변수가 주소 변경을 지정하는 경우 StatusInfo 매개 변수는 IP_ADAPTER_BINDING_INFO 같은 새 주소 정보가 포함된 구조를 가리킵니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

함수가 성공하면 반환 값을 NO_ERROR 합니다.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나여야 합니다.

값	설명
ERROR_CAN_NOT_COMPLETE	지정되지 않은 오류입니다.
ERROR_INVALID_PARAMETER	InterfaceIndex 매개 변수가 잘못되었습니다(예: 해당 인덱스가 있는 인터페이스가 없음).

 

 

요구 사항

지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	routprot.h

추가 정보

AddInterface

DeleteInterface