SoLockManager Class Reference

VSG extension Sets the unlock string. More...

#include <Inventor/lock/SoLockMgr.h>

List of all members.

Static Public Member Functions

static void SetUnlockString (char *pUnlockString)
static void AppendUnlockString (const char *unlockString)

Deprecated



static SoDEPRECATED char * GetUnlockString ()

Detailed Description

VSG extension Sets the unlock string.

This class is used for setting the unlock string (also called "license string" or "password") programmatically. Master passwords and encrypted passwords must be specified via this mechanism.

If your application uses any of the Open Inventor extensions (e.g., MeshViz, VolumeViz, etc.), you will need to specify the necessary license strings using a colon-separated list or a newline-separated list. For encrypted passwords, you must use a newline-separated list. (Since SoLockManager stores only a single string, it would not work to make multiple calls, each specifying a single license string; each call would overwrite the previously specified value.)

You must set the unlock string before your call to SoXt::init, SoWin::init (Windows platforms only), SoDB::init, or IVF_INIT_INSTANCE (Windows MFC- and IVF-based applications).

This means the password string should typically be specified in your application's main, WinMain or CMyApp::InitInstance (for an MFC- and IVF-based application).


Member Function Documentation

static void SoLockManager::AppendUnlockString ( const char *  unlockString  )  [static]

Appends to the existing unlock string the specified string.

In order for the unlock string to be valid, each feature described must be specified in a single line.

static SoDEPRECATED char* SoLockManager::GetUnlockString (  )  [static]

Returns the unlock string.

For security reason, this method always returns NULL.

Returns:
NULL
Deprecated:

Deprecated since Open Inventor 99140
This method should no longer be used. It always returns NULL.
static void SoLockManager::SetUnlockString ( char *  pUnlockString  )  [static]

Sets the unlock string.


SoLockManager makes a copy of the specified string, so it is not necessary to declare a static string.
To reclaim the memory allocated by SoLockManager (for example at program exit), simply call setUnlockString with NULL.


The documentation for this class was generated from the following file:

Open Inventor Toolkit reference manual, generated on 12 Feb 2024
Copyright © Thermo Fisher Scientific All rights reserved.
http://www.openinventor.com/