RtmGetEnumDests 함수(rtmv2.h)

RtmGetEnumDests 함수는 지정된 열거형의 다음 대상 집합을 검색합니다.

구문

DWORD RtmGetEnumDests(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_ENUM_HANDLE   EnumHandle,
  [in, out] PUINT             NumDests,
  [out]     PRTM_DEST_INFO    DestInfos
);

매개 변수

[in] RtmRegHandle

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

[in] EnumHandle

대상 열거형에 대한 핸들입니다.

[in, out] NumDests

입력에서 NumDests는 DestInfos에서 수신할 수 있는 최대 대상 수를 지정하는 UINT 값에 대한 포인터입니다. 출력에서 NumDests는DestInfos에서 받은 실제 대상 수를 받습니다.

[out] DestInfos

입력에서 DestInfos 는 RTM_DEST_INFO 구조체에 대한 포인터입니다.

출력 시 DestInfos 는 대상에 대한 핸들 배열을 받습니다.

반환 값

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

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

설명

DestInfos가 가리키는 구조체는 가변 크기 구조체입니다. 클라이언트가 TargetViews를 사용하여 둘 이상의 보기를 지정하는 경우 각 보기에 대해 DestInfos 크기가 증가합니다. RTM_SIZE_OF_DEST_INFO 매크로를 사용하여 이 함수를 호출하기 전에 할당할 DestInfos 구조체의 용량을 결정합니다. TargetViews에 지정된 값을 매개 변수로 사용하여 RTM_SIZE_OF_DEST_INFO.

대상이 더 이상 필요하지 않은 경우 RtmReleaseDests를 호출하여 해제합니다.

이 함수를 사용하는 샘플 코드는 모든 대상 열거를 참조하세요.

요구 사항

추가 정보

RTM_DEST_INFO

RtmCreateDestEnum

RtmDeleteEnumHandle

RtmReleaseDests