Runtime licensing on end-user PCs

Programs you create that make use of the SDK need to supply a 'runtime' licence key to the SDK classes. Otherwise, calls to SDK classes will throw an exception.

When you enter a trial or full licence key into the SDK Licensing utility (see Licensing on development PCs), the runtime key will be displayed.

In your code, pass the runtime key displayed in the SDK Licensing utility to any instances of FBRecorder, FBEditor or FBVDisk you create. Use the FBRecorder::SetRuntimeLicence, FBEditor::SetRuntimeLicence and FBVDisk::SetRuntimeLicence methods.

For all instances of FBEditor, FBRecorder and FBVDisk, the runtime licence must be set, or calls to any method or read/write of any property will result in an exception being thrown with error code 0x800400FF.

 

Note: when an SDK is operating under a trial licence, the runtime licences it produces will be similarly time-limited. i.e applications produced with an SDK trial licence will not be able to use the SDK classes beyond the trial period.

Note: you can also get the runtime key by calling the GetRuntimeLicence method of the FBRecorder, FBEditor or FBVDisk classes in a program running on a PC with the SDK installed.

Note for Delphi users: Delphi has a limit for string literals of 255 characters. The runtime licence exceeds this limit, so you must break the licence key into two literals. i.e. code like: MyRecorder.SetRuntimeLicence("abcdef..." + "lmnop...");