PGET_EVENT_MESSAGE 콜백 함수(routprot.h)

GetEventMessage 함수는 라우팅 프로토콜의 메시지 큐에서 항목을 가져옵니다. 라우팅 프로토콜은 큐를 사용하여 라우터 관리자에게 비동기 이벤트를 알릴 수 있습니다.

구문

PGET_EVENT_MESSAGE PgetEventMessage;

DWORD PgetEventMessage(
  [out] ROUTING_PROTOCOL_EVENTS *Event,
  [out] MESSAGE *Result
)
{...}

[out] Event

이벤트에 대한 포인터입니다. 이 이벤트에 대한 정보는 연결된 메시지에 보고됩니다. 이벤트 개체가 아닙니다. (ROUTING_PROTOCOL_EVENTS 형식은 Routprot.h에서 선언됩니다.)

이 매개 변수는 다음 값 중 하나를 받습니다.

값	의미
ROUTER_STOPPED	라우터 프로토콜이 성공적으로 종료되었습니다. 이 이벤트에 대한 메시지는 비어 있습니다. ( StopProtocol 참조)
SAVE_GLOBAL_CONFIG_INFO	라우팅 프로토콜은 외부 에이전트, 즉 SetGlobalInfo 이외의 수단을 통해 전역 구성 정보가 변경되었다고 보고합니다. 라우팅 프로토콜은 라우터 관리자가 이 정보를 검색하고 영구적으로 저장할 것을 요청합니다. 이 이벤트에 대한 메시지는 비어 있습니다.
SAVE_INTERFACE_CONFIG_INFO	라우팅 프로토콜은 해당 인터페이스 중 하나와 연결된 구성 정보가 외부 에이전트, 즉 SetInterfaceInfo 이외의 수단을 통해 변경되었다고 보고합니다. 라우팅 프로토콜은 라우터 관리자가 이 정보를 검색하고 영구적으로 저장할 것을 요청합니다. 메시지에는 인터페이스의 ID가 포함됩니다.
UPDATE_COMPLETE	라우팅 프로토콜이 라우터 관리자의 자동 상태 업데이트 요청을 완료했습니다. 라우터 관리자는 수신된 라우팅 정보를 정적으로 변환합니다. 메시지에는 업데이트가 수행된 인터페이스의 인덱스, 수신된 정보의 형식(경로 또는 서비스) 및 업데이트 성공 여부를 나타내는 결과 필드가 포함됩니다. DoUpdateRoutes 및 DoUpdateServices를 참조하세요.

[out] Result

MESSAGE 공용 구조체에 대한 포인터입니다. 메시지의 내용은 보고된 이벤트와 관련이 있습니다.

이 매개 변수는 선택 사항입니다. 호출자는 이 매개 변수에 대해 NULL 을 지정할 수 있습니다.

항목이 성공적으로 검색되면 반환 값이 NO_ERROR.

라우팅 프로토콜의 메시지 큐에 항목이 없으면 반환 값이 ERROR_NO_MORE_ITEMS.