IUnknown::QueryInterface

HRESULT QueryInterface( REFIID iid, void ** ppvObject );

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

S_OK, если данный интерфейс поддерживается объектом, и E_NOINTERFACE в противном случае.

Аргументы

0. iid — идентификатор запрашиваемого интерфейса.

1. ppvObject — адрес указателя на переменную, в которую будет записан указатель на интерфейс, идентификатор которого указан в аргументе iid. В случае успешного завершения операции в переменной *ppvObject содержится указатель на запрашиваемый интерфейс объекта. Если объект не поддерживает данный интерфейс, переменная *ppvObject содержит нулевое значение.

Примечание

Метод QueryInterface позволяет контейнеру получить доступ к интерфейсу объекта. Данный метод возвращает указатель на интерфейс к объекту, указатель, на интерфейс которого является активным в данный момент. Для получения указателя на активный интерфейс следует вызывать метод IUnknown::AddRef.

Для любого объекта одинаковый запрос к интерфейсу IUnknown относительно любого из его интерфейсов должен всегда возвращать одно и тоже значение указателя. Это позволяет контейнеру определить, относятся ли два указателя к одному и тому же компоненту путём вызова метода QueryInterface для каждого из указателей и сравнения результата. Это, однако, не означает, что любой запрос к интерфейсу (даже в случае запроса того же интерфейса через тот же указатель) должен возвращать одно и то же значение указателя.

К реализации метода QueryInterface предъявляется четыре требования (в данном случае термин "должно успешно завершиться" означает "должно успешно завершиться, не вызвав краха системы"):

• Набор интерфейсов, получаемый от объекта с использованием метода QueryInterface должен быть статическим, а не динамическим. Это означает, что если вызов метода QueryInterface для некоторого указателя успешно завершился в первый раз, он должен успешно завершиться и при следующих вызовах. И наоборот: если вызов метода QueryInterface для некоторого указателя не смог успешно завершится в первый раз, он не может успешно завершиться и при следующих вызовах.

• Метод должен быть симметричным: если контейнер имеет указатель на интерфейс объекта и посылает запрос на данный интерфейс, этот запрос должен успешно завершиться.

• Метод доложен быть рефлексивным: если контейнер, имея указатель на интерфейс объекта, может послать успешно завершившийся запрос на другой интерфейс, запрос на первый интерфейс через полученный указатель, также, должен успешно завершиться.

• Метод должен быть транзитивным: если контейнер, имея указатель на интерфейс объекта, может послать успешно завершившийся запрос на другой интерфейс, а через полученный указатель успешно послать запрос на третий интерфейс, запрос на первый интерфейс через указатель на третий интерфейс, также, должен успешно завершиться.

IUnknown::Release

ULONG Release(void);

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

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

Примечание

Уменьшает значение счётчика ссылок вызываемого интерфейса объекта. Если счётчик ссылок принимает нулевое значение, соответствующий объект удаляется из памяти.

Если для данного интерфейса объекта n раз был вызван метод IUnknown::AddRef, а данный вызов метода IUnknown::Release является n+1-м, реализация данного метода должна заставить указатель на интерфейс уничтожить самого себя. Если освобождаемый указатель является единственной ссылкой на объект (независимо от того, использует ли объект единственный или множественный интерфейс), реализация объекта должна его освободить.

Ассоциация объектов ограничивает возможности по восстановлению указателей на интерфейсы.

Использование

Данная функция вызывается после того, как отпала необходимость в использовании данной копии указателя на интерфейс. При написании функции, использующей аргументы для вывода информации, необходимо вызвать метод IUnknown::Release перед копированием выходной величины в аргумент функции.