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

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

Синтаксис

ULONG AddRef();

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

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

Комментарии

COM-объект использует механизм подсчета ссылок для каждого интерфейса, чтобы гарантировать, что объект не перешел на него. Используйте AddRef для стабилизации копии указателя интерфейса. Его также можно вызвать, когда срок жизни клонированного указателя должен превышать время существования исходного указателя. Клонированный указатель должен быть освобожден путем вызова IUnknown::Release .

Внутренний счетчик ссылок, который поддерживает AddRef , должен быть 32-разрядным целым числом без знака.

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

Вызовите этот метод для каждой новой копии указателя интерфейса, который вы делаете. Например, если вы возвращаете копию указателя из метода, необходимо вызвать Метод AddRef для этого указателя. Необходимо также вызвать Метод AddRef для указателя, прежде чем передавать его в качестве входного параметра методу; Метод вызывает IUnknown::Release перед копированием out-value поверх него.

Требования

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

• Интерфейс IUnknown