RtmGetRegisteredEntities 함수(rtmv2.h)

RtmGetRegisteredEntities 함수는 라우팅 테이블 관리자 및 지정된 주소 패밀리의 지정된 instance 등록한 모든 클라이언트에 대한 정보를 반환합니다.

구문

DWORD RtmGetRegisteredEntities(
  [in]      RTM_ENTITY_HANDLE  RtmRegHandle,
  [in, out] PUINT              NumEntities,
  [out]     PRTM_ENTITY_HANDLE EntityHandles,
  [out]     PRTM_ENTITY_INFO   EntityInfos
);

매개 변수

[in] RtmRegHandle

RtmRegisterEntity에 대한 이전 호출에서 얻은 클라이언트에 대한 핸들입니다.

[in, out] NumEntities

입력에서 NumEntities는 EntityInfos에서 수신할 수 있는 최대 클라이언트 수를 지정하는 UINT 값에 대한 포인터입니다. 출력에서 NumEntities 는 EntityInfos에서 받은 실제 클라이언트 수를 받습니다.

[out] EntityHandles

핸들을 반환해야 하는 경우: 입력에서 EntityHandles 는 NULL에 대한 포인터입니다. 출력 시 EntityHandles는 엔 터티 핸들 배열에 대한 포인터를 받습니다. 그렇지 않으면 EntityHandles는 변경되지 않은 상태로 유지됩니다.

핸들을 반환할 필요가 없는 경우: 입력에서 EntityHandles 는 NULL입니다.

[out] EntityInfos

포인터를 반환해야 하는 경우: 입력에서 EntityInfos 는 NULL에 대한 포인터입니다. 출력 시 EntityInfos 는 RTM_ENTITY_INFO 구조체 배열에 대한 포인터를 받습니다. 그렇지 않으면 EntityInfos는 변경되지 않은 상태로 유지됩니다.

포인터를 반환할 필요가 없는 경우: 입력에서 EntityInfos 는 NULL입니다.

반환 값

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

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

설명

ERROR_INSUFFICIENT_BUFFER 반환되는 경우 EntityHandles에 일부 데이터가 있을 수 있습니다. NumEntities 매개 변수는 실제로 반환된 엔터티 수를 지정합니다.

RtmGetRegisteredEntities 함수는 프로토콜을 라우팅하여 해당 주소 패밀리 및 라우팅 테이블 관리자 instance 대해 실행 중인 다른 프로토콜을 확인하는 데 사용할 수 있습니다. 반환된 정보에 따라 클라이언트는 프로토콜별 처리를 수행할 수 있습니다.

RTMv2 API는 라우팅 테이블 관리자의 instance 하나만 지원합니다.

엔터티가 더 이상 필요하지 않은 경우 RtmReleaseEntities를 호출하여 해제합니다.

이 함수를 사용하는 샘플 코드는 등록된 엔터티 열거를 참조하세요.

요구 사항

추가 정보

RTM_ENTITY_INFO

RtmReleaseEntities