Creates a license key that the caller can save and use later to create an instance of the licensed object.
HRESULT RequestLicKey( DWORD dwReserved, BSTR *pBstrKey );
This parameter is reserved and must be zero.
A pointer to the caller-allocated variable that receives the callee-allocated license key on successful return from this method. This parameter is set to NULL on any failure.
This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, and E_UNEXPECTED, as well as the following values.
||The license key was successfully created.|
||This class factory does not support run-time license keys.|
||The address passed in pbstrKey is not valid. For example, it may be NULL.|
||This class factory supports run-time licensing, but the current machine itself is not licensed. Thus, a run-time key is not available on this machine.|
The caller can save the license key for subsequent calls to IClassFactory2::CreateInstanceLic to create objects on an otherwise unlicensed machine.SysFreeString function when the key is no longer needed. The value of fRuntimeKeyAvail is returned through a previous call to IClassFactory2::GetLicInfo. SysAllocString or SysAllocStringLen, and the caller becomes responsible for this BSTR after this method returns successfully.
This method need not be implemented when a class factory does not support run-time license keys.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|