This function initializes the SNF scanning engine using the configuration file and authentication information provided. When SNF is started with this function the identity.xml file can be omitted and the identity= attribute of the <node/> element in snf_engine.xml can be omitted. This allows OEM developers to protect their authentication string by retrieving it from an encrypted source at run-time and providing it directly to the SNF engine.

In all other ways, the SNF engine is configured in the same as when using startupSNF().

Note that if you intend to use this mechanism to protect your SNF license information, you will also need to address the mechanism you use to download and verify rulebase files. Either build a mechanism to download and authenticate your rulebase file without exposing your authentication string or you might modify the existing getRulebase script to remove the snf2check operation and the associated authentication string. The SNF engine will check all rulebase files before they are loaded for scanning and will refuse to load a rulebase file that does not authenticate properly.

path = The full path to the snf_engine.xml file as a null terminated string.

lic = The 8 character license id as a null terminated string.

auth = The 16 character authentication string as a null terminated string.

returns snf_SUCCESS when successful, otherwise see Error Codes.