CComClassFactory2::CreateInstance

 

Creates an object of the specified CLSID and retrieves an interface pointer to this object.

Syntax

      STDMETHOD(CreateInstance)(
   LPUNKNOWN pUnkOuter,
   REFIID riid,
   void** ppvObj 
);

Parameters

  • pUnkOuter
    [in] If the object is being created as part of an aggregate, then pUnkOuter must be the outer unknown. Otherwise, pUnkOuter must be NULL.

  • riid
    [in] The IID of the requested interface. If pUnkOuter is non-NULL, riid must be IID_IUnknown.

  • ppvObj
    [out] A pointer to the interface pointer identified by riid. If the object does not support this interface, ppvObj is set to NULL.

Return Value

A standard HRESULT value.

Remarks

Requires the machine to be fully licensed. If a full machine license does not exist, call CreateInstanceLic.

Requirements

Header: atlcom.h

See Also

CComClassFactory2 Class
CoCreateInstance
CoGetClassObject