Процедура FreeVipInterface

Назначение

Процедура FreeVipInterface освобождает ссылку на загруженный интерфейс, и делает переменную типа ссылки неинициализированной.

Если переменная типа ссылки была ранее инициализирована с помощью функции LoadVipInterface или LoadVipRef, то процедура FreeVipInterface освобождает копию загруженного интерфейса и делает переменную типа ссылки неинициализированной. Перед освобождением интерфейсу передаются события cmOnVipFree и cmOnVipUnLoad.

Если переменная была инициализирована функцией GetVipInterface или GetVipRef, то процедура FreeVipInterface уменьшает счетчик ссылок, делает переменную типа ссылки неинициализированной и передает интерфейсу событие cmOnVipFree. Если счетчик ссылок стал равен нулю - интерфейсу передается событие cmOnVipUnLoad, и он освобождается.

Описание

procedure FreeVipInterface (var ref : VarOfInterFaceType);

Параметры

ref - переменная типа ссылки на интерфейс.

Возвращаемое значение

Высвобождает ссылку и присваивает ей NullRef. Если переменная автоинициализируемая, то сначала произойдёт автоинициализация.

Исключения:

• ExObjIfcBadVar - переменная не является ссылкой на VIP-интерфейс.

Версия

Начиная с Атлантис 5.0.02.