RtmBlockDeleteRoutes 함수

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

RtmBlockDeleteRoutes 함수는 테이블의 지정된 경로 하위 집합에 있는 모든 경로를 삭제합니다.

구문

HANDLE RtmBlockDeleteRoutes(
  _In_ HANDLE ClientHandle,
  _In_ DWORD  EnumerationFlags,
  _In_ PVOID  CriteriaRoute
);

ClientHandle [in]: 삭제할 경로의 클라이언트 및 라우팅 프로토콜을 식별하는 핸들입니다.
EnumerationFlags [in]: 열거할 경로를 지정합니다. 이 매개 변수는 삭제된 경로 집합을 다음 플래그로 정의된 하위 집합으로 제한하고 CriteriaRoute 매개 변수가 가리키는 구조체의 해당 멤버에 있는 값을 제한합니다. RTM_ONLY_BEST_ROUTES RtmBlockDeleteRoutes에 중복된다는 점을 제외하고 플래그는 RtmCreateEnumerationHandle에서 사용되는 플래그와 동일합니다. 경로가 삭제되면 최적 경로 지정이 조정되므로 함수는 결국 하위 집합의 모든 경로를 삭제합니다.
CriteriaRoute [in]: 프로토콜 패밀리별 경로 구조( RTM_IP_ROUTE 또는 RTM_IPX_ROUTE )에 대한 포인터입니다. 이 구조체의 멤버 값은 EnumerationFlags 매개 변수에 지정된 플래그에 해당합니다.

함수가 성공하면 반환 값이 NO_ERROR.

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

값	설명
ERROR_NO_ROUTES	지정된 조건이 있는 경로가 없습니다.
ERROR_INVALID_HANDLE	ClientHandle 매개 변수가 잘못되었습니다.
ERROR_INVALID_PARAMETER	입력 매개 변수 중 하나 이상이 잘못되었습니다. 예를 들어 열거형 플래그가 잘못되었습니다.
ERROR_NO_SYSTEM_RESOURCES	작업을 수행할 리소스가 부족합니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 수행하기에 메모리가 부족합니다.

함수는 호출자를 포함하여 등록된 모든 클라이언트에 적절한 알림 메시지를 생성합니다.

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