CherSoft Ltd www.chersoft.co.uk Home   About   Advantages   Developer Reference   Downloads   FAQ   Contact

Getting the Installation ID

By Andrew Nibbs

Thursday, April 14, 2005

Installation ID is
81000-04Z9Q-F06KQ-QCR6D-8MDFV-7CC84-EM17J-ZB8WA-R7UV4
Press any key to continue

ENCX can be licensed using a "software" dongle licensing scheme. It can also use a hardware dongle which may be more appropriate in certain situations.

To license ENCX for a particular machine you need to get the Installation ID for that machine. The ID is a string of letters which identifies the product to be licensed and contains information to identify that specific machine. In exchange for this ID CherSoft will issue a dongle-free security (DFS) file. This file can only be decrypted on that specific machine thanks to the machine identity information in the installation ID.

The installation ID is obtained through the InstallationID property of an ENCX library object. The short command line sample InstallationId outputs it to the console.

#include "stdafx.h"
#import "encxcom.tlb" rename_namespace("encx")

int _tmain(int argc, _TCHAR* argv[])
{
 ::CoInitialize(NULL);

 try
 {
  encx::ILibraryPtr pEncx(__uuidof(encx::Library));
  pEncx->Construct("","");

  const _bstr_t bsInstallId = pEncx->DFSInstallationId;

  std::cout << "Installation ID is" << std::endl
            << LPCTSTR(bsInstallId) << std::endl;
 }
 catch (const _com_error& e)
 {
  std::cout << e.ErrorMessage() << std::endl
            << e.Description() << std::endl;
 }

 ::CoUninitialize();
 return 0;
}

When the library object is constructed in the example above no OEM key is specified. As such the 'product' contained in the installation ID is ENCX Default. See the link for more information.

ENCX Home