RtmReleaseChangedDests 함수(rtmv2.h)

RtmReleaseChangedDests 함수는 변경된 대상 핸들을 해제합니다.

구문

DWORD RtmReleaseChangedDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_INFO    ChangedDests
);

매개 변수

[in] RtmRegHandle

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

[in] NotifyHandle

RtmRegisterForChangeNotification에 대한 이전 호출에서 가져온 변경 알림에 대한 핸들입니다.

[in] NumDests

ChangedDests의 대상 수를 지정합니다.

[in] ChangedDests

해제할 RTM_DEST_INFO 구조체의 배열에 대한 포인터입니다. 변경된 대상은 RtmGetChangedDests에 대한 이전 호출에서 얻은 것입니다.

반환 값

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

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

값	의미
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다.

설명

항상 이 함수를 사용하여 RtmGetChangedDests 호출에서 가져온 변경된 RTM_DEST_INFO 구조를 해제합니다.

RTM_DEST_INFO 구조체는 가변 크기 구조체입니다. 대상에 둘 이상의 보기에 대한 정보가 포함된 경우 각 보기에 대한 RTM_DEST_INFO 크기가 증가합니다. 이 함수를 호출하기 전에 RTM_SIZE_OF_DEST_INFO 매크로를 사용하여 ChangedDests 버퍼를 할당할 용량을 확인합니다.

요구 사항

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