Initializes the Spatial+ library.
Syntax
pipHandle pipInit ( intl licensePassword, pstr licenseFilename );
Arguments
licensePassword The password for the license file (obtained from Precisely). Input. licenseFilename Complete path and filename of the license file. Input.
Return Value
A non-NULL value represents a valid handle. NULL indicates a failure to create a handle; most likely due to system error.
Prerequisites
None.
Alternates
None.
Notes
Initializes the Spatial+ library. pipInit does not actually check the license file. It merely records the password and filename for verification in the following functions: pipImportInit, pipObjectFileOpen, pipZip4FileOpen, pipRadInit.
Example
/* initializes, then terminates, the Spatial+ library */ pipHandle h;
h = pipInit( 11111111, "c:\\lic\\SPATIAL.LIC" ); if ( h == NULL )
{
printf("Spatial+ failed to initialize"); return( 1 );
}
/*If we get here, we have initialized, so perform work with Spatial+ ...*/
/* ... we are now finished with Spatial+, so terminate */ pipTerm( h );