com.jniwrapper.win32.com
Interface IClassFactory2

All Superinterfaces:

AutoDeleteParameter, IClassFactory, IUnknown

All Known Implementing Classes:

IClassFactory2Impl

public interface IClassFactory2

extends IClassFactory

This interface enables a class factory object, in any sort of object server, to control object creation through licensing.

Field Summary

static java.lang.String

INTERFACE_IDENTIFIER

Method Summary

void	createInstanceLic(IUnknown outer, IUnknown reserved, IID iid, BStr bstrKey, IUnknown result) Creates an instance of the licensed object given a license key from requestLicKey(com.jniwrapper.UInt32, com.jniwrapper.win32.automation.types.BStr)
void	getLicInfo(LicInfo licInfo) Fills a licInfo structure with information on the licensing capabilities of this class factory.
void	requestLicKey(UInt32 reserved, BStr key) Creates and returns a license key that the caller can save and use later in calls to createInstanceLic(IUnknown, IUnknown, com.jniwrapper.win32.com.types.IID, com.jniwrapper.win32.automation.types.BStr, IUnknown).

Methods inherited from interface com.jniwrapper.win32.com.IClassFactory

createInstance, createInstance, lockServer

Methods inherited from interface com.jniwrapper.win32.com.IUnknown

addRef, isNull, queryInterface, release, setNull

Methods inherited from interface com.jniwrapper.AutoDeleteParameter

isAutoDelete, setAutoDelete

Field Detail

INTERFACE_IDENTIFIER

public static final java.lang.String INTERFACE_IDENTIFIER

See Also:

Constant Field Values

Method Detail

getLicInfo

public void getLicInfo(LicInfo licInfo)
                throws ComException

Fills a licInfo structure with information on the licensing capabilities of this class factory.

Parameters:

licInfo - [out] structure to be filled on output.

Throws:

ComException

requestLicKey

public void requestLicKey(UInt32 reserved,
                          BStr key)
                   throws ComException

Creates and returns a license key that the caller can save and use later in calls to createInstanceLic(IUnknown, IUnknown, com.jniwrapper.win32.com.types.IID, com.jniwrapper.win32.automation.types.BStr, IUnknown).

Parameters:

reserved - Reserved. Must be zero.

key - [out]parameter that receives the license key.

Throws:

ComException

createInstanceLic

public void createInstanceLic(IUnknown outer,
                              IUnknown reserved,
                              IID iid,
                              BStr bstrKey,
                              IUnknown result)
                       throws ComException

Creates an instance of the licensed object given a license key from requestLicKey(com.jniwrapper.UInt32, com.jniwrapper.win32.automation.types.BStr)

Parameters:

outer - [in] parameter, points to controlling interface of an aggregate, or null if the object isn't being created as part of an aggregate.

reserved - Unused. Must be null.

iid - identifier of the interface to be used to communicate with the newly created object.

bstrKey - license key previously obtained from requestLicKey(com.jniwrapper.UInt32, com.jniwrapper.win32.automation.types.BStr)

result - [out] parameter, instance implementing a required interface.

Throws:

ComException