RtmDequeueRouteChangeMessage 함수

[이 API는 라우팅 테이블 관리자 버전 2 API로 대체되었으며 Windows Server 2003 이상에서는 사용할 수 없습니다. 애플리케이션은 라우팅 테이블 관리자 버전 2 API를 사용해야 합니다.]

RtmDequeueRouteChangeMessage 함수는 지정된 클라이언트와 연결된 큐에서 다음 경로 변경 메시지를 반환합니다.

구문

DWORD RtmDequeueRouteChangeMessage(
  _In_  HANDLE ClientHandle,
  _Out_ DWORD  Flags,
  _Out_ PVOID  CurBestRoute,
  _Out_ PVOID  PrevBestRoute
);

ClientHandle [in]

작업이 수행되는 클라이언트를 식별하는 핸들입니다. RtmRegisterClient를 호출하여 이 핸들을 가져옵니다.

플래그 [out]

DWORD 변수에 대한 포인터입니다. 이 변수의 값은 라우팅 테이블 관리자에 의해 설정됩니다. 값은 변경 메시지의 유형과 제공된 버퍼에 반환된 정보를 지정합니다. 이 매개 변수는 다음 중 하나입니다.

플래그	의미
RTM_ROUTE_ADDED	특정 대상 네트워크에 대한 첫 번째 경로가 추가되었습니다. CurBestRoute 매개 변수는 추가된 경로에 대한 정보를 가리킵니다.
RTM_ROUTE_DELETED	특정 대상 네트워크에 사용할 수 있는 유일한 경로가 삭제되었습니다. PrevBestRoute 매개 변수는 삭제된 경로에 대한 정보를 가리킵니다.
RTM_ROUTE_CHANGED	특정 대상 네트워크에 대한 최상의 경로를 위해 중요한 매개 변수 중 하나 이상이 변경되었습니다. 중요한 매개 변수는 다음과 같습니다. 프로토콜 식별자 인터페이스 인덱스 다음 홉 주소 프로토콜 패밀리별 데이터(경로 메트릭 포함)

PrevBestRoute 매개 변수는 변경 전과 마찬가지로 경로 정보를 가리킵니다. CurBestRoute 매개 변수는 현재(즉, 변경 후) 경로 정보를 가리킵니다.

CurBestRoute [out]

현재 최적 경로 정보를 수신하는 구조체에 대한 포인터입니다(있는 경우). 구조체의 형식은 프로토콜 패밀리(예: IP 또는 IPX)에 따라 다릅니다.

이 매개 변수는 선택 사항입니다. 호출자가 이 매개 변수에 대해 NULL 을 지정하는 경우 현재 최적 경로 정보가 반환되지 않습니다.

PrevBestRoute [out]

이전 최상의 경로 정보를 수신하는 구조체에 대한 포인터입니다(있는 경우). 구조체의 형식은 프로토콜 패밀리(예: IP 또는 IPX)에 따라 다릅니다.

이 매개 변수는 선택 사항입니다. 호출자가 이 매개 변수에 대해 NULL 을 지정하는 경우 이전의 최상의 경로 정보가 반환되지 않습니다.

반환 값은 다음 코드 중 하나입니다.

값	Description
NO_ERROR	이 메시지는 클라이언트 큐의 마지막 메시지였습니다. 이벤트 개체가 다시 설정됩니다.
ERROR_INVALID_HANDLE	ClientHandle 매개 변수가 유효한 핸들이 아니거나 등록 시 클라이언트가 변경 메시지 알림에 대한 이벤트 개체를 제공하지 않았습니다(RtmRegisterClient 참조).
ERROR_MORE_MESSAGES	클라이언트의 큐에는 추가 메시지가 포함됩니다. 클라이언트는 라우팅 테이블 관리자가 보류 중인 메시지와 연결된 리소스를 해제할 수 있도록 가능한 한 빨리 RtmDequeueRouteChangeMessage 를 다시 호출해야 합니다.
ERROR_NO_MESSAGES	클라이언트의 큐에 메시지가 없습니다. 요청이 요청되지 않았습니다. 이벤트가 다시 설정됩니다.
ERROR_NO_SYSTEM_RESOURCES	작업을 수행할 리소스가 부족합니다.

이 페이지가 도움이 되었나요?