Функция RtmReleaseChangedDests (rtmv2.h)

Статья
03/01/2024

Функция 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	Дескриптор недействителен.

Структура RTM_DEST_INFO является структурой переменной величины. Если назначение содержит сведения о нескольких представлениях, размер RTM_DEST_INFO увеличивается для каждого представления. Используйте макрос RTM_SIZE_OF_DEST_INFO , чтобы определить, насколько велик буфер ChangedDests для выделения перед вызовом этой функции.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	rtmv2.h
Библиотека	Rtm.lib
DLL	Rtm.dll