IUnknown

In the computer programming of applications on Microsoft Windows through the Windows API, the IUnknown interface is the fundamental interface of Component Object Model (COM). The COM specification mandates that COM objects must implement this interface. Furthermore, every other COM interface must be derived from IUnknown . IUnknown resides in the global namespace. IUnknown exposes two essential features of all COM objects: object lifetime management through reference counting, and access to object functionality through other interfaces. As well as being a foundational part of Microsoft's COM and DCOM models of objects, there are implementations of the same interface on other platforms -either because the other platforms implement some form of COM-compatibility, or because the design was considered effective. An IUnknown (or IUnknown -derived) interface generally consists of a pointer to a virtual method table that contains a list of pointers to the functions that implement the functions declared in the interface, in the order that they are declared in the interface. The in-process invocation call overhead is therefore identical to virtual method calls in C++.

In the computer programming of applications on Microsoft Windows through the Windows API, the IUnknown interface is the fundamental interface of Component Object Model (COM). The COM specification mandates that COM objects must implement this interface. Furthermore, every other COM interface must be derived from IUnknown . IUnknown resides in the global namespace. IUnknown exposes two essential features of all COM objects: object lifetime management through reference counting, and access to object functionality through other interfaces. As well as being a foundational part of Microsoft's COM and DCOM models of objects, there are implementations of the same interface on other platforms -either because the other platforms implement some form of COM-compatibility, or because the design was considered effective. An IUnknown (or IUnknown -derived) interface generally consists of a pointer to a virtual method table that contains a list of pointers to the functions that implement the functions declared in the interface, in the order that they are declared in the interface. The in-process invocation call overhead is therefore identical to virtual method calls in C++. ==Methods== The IUnknown interface exposes three methods: QueryInterface() , AddRef() , and Release() : QueryInterface() allows the caller to retrieve references to the interfaces that the component implements. It is similar to dynamic_cast in C++ or casts in Java and C#. Specifically, it is used to obtain a pointer to another interface, given a GUID that uniquely identifies that interface (commonly known as an interface ID, or IID). If the COM object does not implement that interface, an E_NOINTERFACE error is returned instead. AddRef() is used to increment the reference count when a new client is acquiring the object. It returns the new reference count. Release() is used to decrement the reference count when clients have finished using the object. It returns the new reference count. The object will delete itself during release when the reference-count reaches zero, which means that the caller must never use an interface after calling Release. interface IUnknown { virtual HRESULT QueryInterface(REFIID riid, void** ppvObject) = 0; virtual ULONG AddRef() = 0; virtual ULONG Release() = 0; }; The IUnknown interface ID is defined as a GUID with the value of {00000000-0000-0000-C000-000000000046}. A COM component's interfaces are required to exhibit the reflexive, symmetric, and transitive properties. The reflexive property refers to the ability for the QueryInterface() call on a given interface with the interface's ID to return the same instance of the interface. The symmetric property requires that when interface B is retrieved from interface A via QueryInterface() , interface A is retrievable from interface B as well. The transitive property requires that if interface B is obtainable from interface A and interface C is obtainable from interface B , then interface C should be retrievable from interface A . ==See also== IOleObject - This is the base interface for Object Linking and Embedding (OLE) objects. IDispatch - This interface provides name-based dynamic method dispatch for OLE Automation COM objects IObjectWithSite - This COM interface allows a parent/child pair of objects to connect to each other to implement a Browser Helper Object (BHO) IInspectable - The COM-derived Windows Runtime (WinRT) uses this IUnknown-derived interface as its base interface ==References== ==External links== COM in plain C

Text derived from https://en.wikipedia.org/w/index.php?oldid=1357668746 under CC BY-SA 4.0; modifications have been made.