Метод IUnknown::Release (unknwn.h)

  • Статья

Уменьшает количество ссылок для интерфейса в COM-объекте.

Синтаксис

ULONG Release();

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

Метод возвращает новое число ссылок. Это значение предназначено для использования только в целях тестирования.

Комментарии

Когда количество ссылок на объект достигает нуля, выпуск должен привести к освобождению указателя интерфейса. Если освобожденный указатель является единственной (ранее) неопубликоченной ссылкой на объект (независимо от того, поддерживает ли объект один или несколько интерфейсов), реализация должна освободить объект.

Обратите внимание, что агрегирование объектов ограничивает возможность восстановления указателей интерфейса.

Примечания для вызывающих абонентов

Вызовите этот метод, если вам больше не нужно использовать указатель интерфейса. При написании метода, который принимает входной параметр, вызовите Release для передаваемого указателя, прежде чем копировать поверх него значение.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header unknwn.h

См. также раздел