CComClassFactory2::CreateInstanceLic

Similar to CreateInstance, except that CreateInstanceLic requires a license key.

STDMETHOD(CreateInstanceLic)( 
   IUnknown* pUnkOuter, 
   IUnknown* /* pUnkReserved */, 
   REFIID riid, 
   BSTR bstrKey, 
   void** ppvObject  
);

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.

  • pUnkReserved
    [in] Not used. Must be NULL.

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

  • bstrKey
    [in] The run-time license key previously obtained from a call to RequestLicKey. This key is required to create the object.

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

Return Value

A standard HRESULT value.

Remarks

You can obtain a license key using RequestLicKey. In order to create an object on an unlicensed machine, you must call CreateInstanceLic.

Requirements

Header: atlcom.h

See Also

Reference

CComClassFactory2 Class

CoCreateInstance

CoGetClassObject