VXPLib Documentation: COM

IVXPQuickHTML::GetLicenses

Returns the number of valid licenses available to the current client application.
HRESULT GetLicenses(long * nLicenses);
Parameters

nLicenses [out, retval] - Return value: the number of valid licenses (read Remarks)
Remarks

You can call this function from your client application to find out how many valid licenses are available to the application. If your application is not licensed to use VXPLib.dll the function returns 0, and functionality of the component will be limited as described in this online document.

When purchasing a license online you are given a license key that contains such information as when the key was generated and how many licenses the key represents. Using the license key you can create file VXPLib.lic. Details on how to create such file available upon purchasing a license.

  • For an EXE client to be recognized as licensed it needs file VXPLib.lic to always present in the same directory as the EXE module. Alternatively, the EXE module can link to VXPLib.lic by inserting the file as a program resource of type "VXPLib" and name "Lic". In both cases file VXPLib.lic is implied to contain full name of the EXE module granted the license rights.
  • If you write a DLL module that will be using VXPLib.dll such module is considered licensed, if the EXE module that uses the DLL is licensed.
  • If you write a middle-ware component or library (DLL, OCX, CPL, ...) to be distributed on its own, and such library uses VXPLib.dll such module must come with VXPLib.lic containing full name of the module. The VXPLib.lic in this case is to be placed in the same directory as the end EXE module that will be using your component. Such VXPLib.lic doesn't need to contain full name of the EXE module, as it doesn't need additional licensing. However, when using VXPLib.lic in this way the License Agreement of the VXPLib.dll component obligates you to negotiate terms of such solution separately.

When in doubt whether your client application is recognized as licensed just call method AboutBox to bring up license information available to your client application.
See Also
IVXPQuickHTML Overview | AboutBox
This document was last updated on 14/05/2003
Copyright © 2003 Tooltips.NET