Visual Studio

The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CComPtrBase::CoCreateInstance

Other Versions

Call this method to create an object of the class associated with a specified Class ID or Program ID.

Syntax


      HRESULT CoCreateInstance(
   LPCOLESTR szProgID,
   LPUNKNOWN pUnkOuter = NULL,
   DWORD dwClsContext = CLSCTX_ALL 
) throw( );
HRESULT CoCreateInstance(
   REFCLSID rclsid,
   LPUNKNOWN pUnkOuter = NULL,
   DWORD dwClsContext = CLSCTX_ALL 
) throw( );

Parameters

szProgID: Pointer to a ProgID, used to recover the CLSID.
pUnkOuter: If NULL, indicates that the object is not being created as part of an aggregate. If non-NULL, is a pointer to the aggregate object's IUnknown interface (the controlling IUnknown).
dwClsContext: Context in which the code that manages the newly created object will run.
rclsid: CLSID associated with the data and code that will be used to create the object.

Return Value

Returns S_OK on success, or REGDB_E_CLASSNOTREG, CLASS_E_NOAGGREGATION, CO_E_CLASSSTRING or E_NOINTERFACE on failure. See CoCreateClassInstance and CLSIDFromProgID for a description of these errors.

Remarks

If the first form of the method is called, CLSIDFromProgID is used to recover the CLSID. Both forms then call CoCreateClassInstance.

In debug builds, an assertion error will occur if CComPtrBase::p is not equal to NULL.

Requirements

Header: atlcomcli.h