RtmGetChangedDests 함수(rtmv2.h)

아티클
03/01/2024

RtmGetChangedDests 함수는 변경된 정보가 있는 대상 집합을 반환합니다.

구문

DWORD RtmGetChangedDests(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_NOTIFY_HANDLE NotifyHandle,
  [in, out] PUINT             NumDests,
  [out]     PRTM_DEST_INFO    ChangedDests
);

매개 변수

[in] RtmRegHandle

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

[in] NotifyHandle

RtmRegisterForChangeNotification에 대한 이전 호출에서 얻은 변경 알림에 대한 핸들입니다.

[in, out] NumDests

입력에서 NumDests는 ChangedDests에서 수신할 수 있는 최대 대상 수를 지정하는 UINT 값에 대한 포인터입니다.

출력에서 NumDests는ChangedDests에서 받은 실제 대상 수를 받습니다.

[out] ChangedDests

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

출력에서 ChangedDests 는 변경된 대상 정보로 채워집니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	매개 변수에 잘못된 정보가 포함되어 있습니다.
ERROR_NO_MORE_ITEMS	검색할 대상을 더 이상 변경하지 않습니다.

설명

클라이언트는 RTM_EVENT_CALLBACK 변경 내용에 대한 알림을 받습니다. RTM_EVENT_CALLBACK 변경 내용을 전달하지 않고 클라이언트에 알리는 데만 사용됩니다. 변경 알림을 받은 후 클라이언트는 RtmGetChangedDests를 반복적으로 호출하여 모든 변경 내용을 검색해야 합니다.

알림 이후 동일한 대상에 대한 두 개 이상의 변경 내용이 발생한 경우 최신 변경 내용만 반환됩니다.

클라이언트에 ChangedDests의 핸들이 더 이상 필요하지 않은 경우 클라이언트는 RtmReleaseChangedDests를 사용하여 핸들을 해제해야 합니다.

이 함수를 사용하는 샘플 코드는 이벤트 알림 콜백 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	rtmv2.h
라이브러리	Rtm.lib
DLL	Rtm.dll