Функция RtmReleaseDests (rtmv2.h)
Функция RtmReleaseDests освобождает дескрипторы назначения.
Синтаксис
DWORD RtmReleaseDests(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] UINT NumDests,
[in] PRTM_DEST_INFO DestInfos
);
Параметры
[in] RtmRegHandle
Дескриптор клиента, полученного из предыдущего вызова RtmRegisterEntity.
[in] NumDests
Указывает количество назначений в DestInfos.
[in] DestInfos
Указатель на массив RTM_DEST_INFO структур для освобождения. Назначения были получены из предыдущего вызова RtmGetEnumDests.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.
| Значение | Значение |
|---|---|
|
Дескриптор недействителен. |
Комментарии
Не используйте эту функцию для освобождения RTM_DEST_INFO структур, полученных из вызова RtmGetChangedDests. Вместо этого используйте RtmReleaseChangedDests .
Структура RTM_DEST_INFO является структурой переменной величины. Если назначение содержит сведения о нескольких представлениях, размер RTM_DEST_INFO увеличивается для каждого представления. Используйте макрос RTM_SIZE_OF_DEST_INFO , чтобы определить, насколько велик буфер DestInfos для выделения перед вызовом этой функции.
Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | rtmv2.h |
| Библиотека | Rtm.lib |
| DLL | Rtm.dll |