registration.htm

acis说明文档

      <span class="kw4">const</span> <span class="kw2">wchar_t</span>* application_name,
      <span class="kw4">const</span> <span class="kw2">wchar_t</span>* user_company_name,
      spa_lic_purpose license_purpose,
      <span class="kw4">const</span> <span class="kw2">wchar_t</span>* err_report_file=<span class="kw2">NULL</span>,
      <span class="kw5">logical</span> display_internet_access_panel=<span class="kw2">TRUE</span><span class="br0">&#41;</span>;
&nbsp;
<span class="kw5">logical</span> spa_lic_register_product <span class="br0">&#40;</span>
      <span class="kw4">int</span> app_key_index,
      <span class="kw4">const</span> <span class="kw4">char</span>* version,
      <span class="kw4">const</span> <span class="kw4">char</span>* customer_name,
      <span class="kw4">const</span> <span class="kw4">char</span>* application_name,
      <span class="kw4">const</span> <span class="kw4">char</span>* user_company_name,
      spa_lic_purpose license_purpose,
      <span class="kw4">const</span> <span class="kw4">char</span>* err_report_file=<span class="kw2">NULL</span>,
      <span class="kw5">logical</span> display_internet_access_panel=<span class="kw2">TRUE</span><span class="br0">&#41;</span>;</pre>
<a name="Parameters"></a><h3> <span class="mw-headline"> Parameters </span></h3>
<p>Specifically, the parameters are defined as follows:
</p>
<ul><li> <i>app_key_index</i> is the application key index provided to the Spatial customer through Spatial's Licensing Web site.
</li><li> <i>version</i> is the component version provided to the Spatial customer through Spatial's Licensing Web site.
</li><li> <i>customer_name</i> is the Spatial's customer name as supplied on Spatial's Licensing Web site.
</li><li> <i>application_name</i> is the name of the application being installed as supplied on Spatial's Licensing Web site.
</li><li> <i>user_company_name</i> is the name of the company where the application is going to be used.
</li><li> <i>license_purpose</i> is the installation purpose: Production, Evaluation, or Temporary. Specifying your installation purpose ensures accuracy for the registration process. Each purpose is defined as follows:
<ul><li> <b>Production </b>  Indicates that this installation is for permanent production.
</li><li> <b>Evaluation </b>  Indicates that this installation is for evaluation use, such as Demos or Betas.
</li><li> <b>Temporary </b> Indicates that this installation is for short-term use. When the registration purpose is Temporary, registration with Spatial is actually skipped.
</li></ul>
</li></ul>
<p>In order to support installers that use either wide character strings or ASCII strings, two versions of the registration API have been supplied: a wchar_t version and a const char * version. Note that on Microsoft C/C++ compilers greater than version 1300, the wchar_t type will actually be one of two types: unsigned short by default, __wchar_t if the compiler option /Zc:wchar_t is used. Implementations of the registration API are provided for both types of wchar_t.
</p>
<ul><li> <i>err_report_file</i> is the path for saving an error report file for analyzing the end users' registration issues. The default is <b>NULL</b>.
</li><li> <i>display_internet_access_panel</i> determines whether to notify the end user with a message dialog that Internet access is required for registration. Set this parameter to <b>TRUE</b> to enable notification; otherwise, <b>FALSE</b>. The default is <b>TRUE</b>.
</li></ul>
<a name="Returns"></a><h3> <span class="mw-headline"> Returns </span></h3>
<p>Possible return values are as follows:
</p>
<ul><li><tt>TRUE</tt> indicates license installation was successful.
</li><li><tt>FALSE</tt> indicates license installation was unsuccessful.
</li></ul>
<a name="Proxy_Login_Information"></a><h3> <span class="mw-headline"> Proxy Login Information </span></h3>
<p>When the Registration function attempts to access the Internet, a new window is displayed asking the user for proxy login information if proxy authentication is required. The information needed includes:
</p>
<ul><li> username
</li><li> password
</li><li> proxy server
</li><li> proxy server port number
</li></ul>
<p><a href="/r18/index.php/Image:AI_proxylogin.png" title="Image:AI proxylogin.png">Image:AI proxylogin.png</a>
</p>
<a name="Notes"></a><h3> <span class="mw-headline"> Notes </span></h3>
<p>The network message window is enabled by default as it is required by anti-spyware statutes in some locations. The window can be disabled by providing a <b>FALSE</b> value for the <i>display_internet_access_panel</i> argument. If you choose <b>FALSE</b>, then you must supply your own form of notification; do not avoid notification altogether.
</p>
<dl><dd> <b>IMPORTANT!</b> - Spatial customers who choose the value <b>FALSE</b> for the <i>display_internet_access_panel</i> argument accept sole responsibility for the behavior of their installer, including Spatial's registration process, especially in locations where anti-spyware statutes apply.
</dd></dl>
<p>The Spatial registration function requires the following files in order to run; they must be in the same folder, redistributed with the registration API and registration GUI:
</p>
<ul><li> SpaBase.dll
</li><li> SpaLicExtBase.dll
</li><li> SpaLicExtReg.dll
</li><li> SpaLicHttpProxyGUI.dll
</li><li> Wininet.dll
</li><li> Microsoft runtime corresponding to the Spatial Arch you are redistributing
</li></ul>
<p>The registration DLLs are not shipped on any debug arches.
</p>
<a name="Spatial_Registration_Utility"></a><h2> <span class="mw-headline"> Spatial Registration Utility </span></h2>
<p>Spatial has provided a registration utility for you to use and redistribute to your end users. Its primary purpose is to perform registration in the event of a previously failed registration attempt. The utility also provides a means to manually register without using an installer by entering all of the parameters of the registration function (refer to #util_noinstall Registering without an Installer for more information).
</p><p>The Spatial Registration Utility requires an Internet connection. Typically, use of this utility occurs for those needing to register machines that do not have Internet access. Run the utility from an administrator machine with both Internet access and LAN access to the target machines.
</p>
<a name="Notes_2"></a><h3> <span class="mw-headline"> Notes </span></h3>
<p>The Spatial Registration Utility uses functionality that is not supported by Visual C++ 6 SP5. For this platform, the GUI built with Visual Studio .NET 2003 is provided in the bin/NT_NET_DLL directory.
</p><p>The Spatial Registration Utility is not supported on Windows 2000 or earlier operating systems.
</p><p>The Spatial Registration Utility requires the following files in order to run; they must be in the same folder, redistributed with the registration API and registration GUI:
</p>
<ul><li> SpaBase.dll
</li><li> SpaLicExtBase.dll
</li><li> SpaLicExtReg.dll
</li><li> SpaLicHttpProxyGUI.dll
</li><li> Wininet.dll
</li><li> Microsoft runtime corresponding to the Spatial Arch you are redistributing
</li></ul>
<p>The Spatial Registration Utility is not shipped on any debug arches.
</p><p>The Spatial Registration Utility requests proxy #logininfo login information if proxy authentication is required.
</p>
<a name="Components_of_the_Spatial_Registration_Utility"></a><h3> <span class="mw-headline"> Components of the Spatial Registration Utility </span></h3>
<p>The utility consists of three tabs: <b>Local</b>, <b>Network</b>, and <b>Application</b>.
</p>
<a name="Local_Tab"></a><h4> <span class="mw-headline"> Local Tab </span></h4>
<p>The <b>Local</b> tab allows you to register installations of Spatial-enabled applications for this machine (the machine on which the utility is running). Upon enabling the utility, all applications for which registration has been attempted are shown. Every time the <b>Local</b> tab is accessed, this automatically refreshes the list of applications.
</p>
<div class="thumb tright"><div class="thumbinner" style="width:182px;"><a href="/r18/index.php/Image:AI_util_local.png" title="Image:AI util local.png">Image:AI util local.png</a>  <div class="thumbcaption">Local tab</div></div></div>
<a name="Network_Tab"></a><h4> <span class="mw-headline"> Network Tab </span></h4>
<p>The <b>Network</b> tab allows you to register remote machines having applications that use Spatial products. Upon enabling the utility, the list of remote machine applications is empty. Once you supply a list of remote machines, each machine is accessed, and the pane displays all applications for which registration has been attempted. Every time the <b>Network</b> tab is accessed, this automatically refreshes the network machines list.
</p><p><a href="/r18/index.php/Image:AI_util_netwk.png" title="Image:AI util netwk.png">Image:AI util netwk.png</a>
</p>
<a name="Application_Tab"></a><h4> <span class="mw-headline"> Application Tab </span></h4>
<p>The <b>Application</b> tab allows you to manually register your machines having applications that use Spatial products by entering the same parameters as the registration function.
<a href="/r18/index.php/Image:AI_util_appl.png" title="Image:AI util appl.png">Image:AI util appl.png</a>
</p>
<a name="Registering_Your_Machines_Using_the_Spatial_Registration_Utility"></a><h3> <span class="mw-headline"> Registering Your Machines Using the Spatial Registration Utility </span></h3>
<p>You may choose to register your applications with the utility because you may be:
</p>
<ul><li> Recovering from a failed registration attempted by your product installer on a single machine or on multiple machines accessible across a LAN
</li><li> Registering without using an installer
</li></ul>
<a name="Recovering_from_a_Failed_Registration_Attempted_by_Your_Product_Installer"></a><h4> <span class="mw-headline"> Recovering from a Failed Registration Attempted by Your Product Installer </span></h4>
<p>If you have attempted to register your Spatial products with your product installer by calling the Spatial registration API, and the registration was unsuccessful, then you may register using the Spatial Registration Utility.
</p><p>Before you begin, ensure the following prerequisites:
</p>
<ul><li> You are using the Spatial Registration utility on the same machine where the installation took place.
</li><li> Your machine has Internet access and authorization to make an HTTPS connection to the Spatial registration server.
</li><li> The Spatial Registration utility is installed on your machine.
</li></ul>
<p>To register your machine:
</p>
<ol><li> Launch the utility, spa_lic_app.exe. Applications that access Spatial products appear in the <b>Local</b> tab of the utility and display their current state of registration.
</li><li> Select the application that you wish to complete registration. The <b>Register</b> button becomes enabled.
</li><li> Select the <b>Register</b> button. The utility contacts the registration server and registers the application.
</li><li> Check the Status field for the recently registered application:
<ul><li> If the Status field shows that registration was successful, you may close the utility.
</li><li> If the registration status shows that the process was unsuccessful, then an error log can be retrieved by selecting the enabled <b>Save Log...</b> button. Proceed to #troubleshooting Troubleshooting Registration Failures.
</li></ul>
</li></ol>
<a name="Registering_Remote_Machines_without_Network_Access"></a><h4> <span class="mw-headline"> Registering Remote Machines without Network Access </span></h4>
<p>If you have attempted to register remote machines with your product installer by calling the Spatial registration API, and the registration was unsuccessful, then you may register using the Spatial Registration Utility.
</p><p>Before you begin, ensure the following prerequisites:
</p>
<ul><li> The remote machines on which the installation took place are accessible from your machine through the Local Area Network.
</li><li> Your machine has Internet access and authorization to make an HTTPS connection to the Spatial registration server.
</li><li> You have administrator privileges for allowing the Spatial Registration Utility to modify Windows registry on the remote machines.
</li><li> The Spatial Registration Utility is installed on your machine.
</li><li> For all unregistered remote machine on your LAN that accesses Spatial products, you must include their DNS name and IP address in a single text file. You can create the file with Notepad or any other text editor that saves its contents as ASCII or UTF-8.
</li></ul>
<p>To register your remote machines:
</p>
<ol><li> Launch the utility, spa_lic_app.exe.
</li><li> Select the <b>Network</b> tab.
</li><li> Select the <b>Node List...</b> button. A standard Windows Open dialog appears.
</li><li> Select the text file that contains the list of machines accessible on the network. This list may be a comprehensive list of machines accessible on the network or may contain solely those you wish to have registered. The utility opens the file and displays the list of installed applications containing Spatial products and their current state of registration in the <b>Network</b> tab.
</li><li> From the list in the <b>Network</b> tab, select the applications for which you wish to complete their registration. Use the CTRL and Shift keys to select individual rows or groups of rows. You may sort the rows by machine name, application name, license type, expiration date, or by status by clicking on the column heading. The <b>Register</b> button becomes enabled.
</li><li> Select the <b>Register</b> button. The utility contacts the registration server and registers the application.
</li><li> Check the Status field for the recently registered application:
<ul><li> If the Status field shows that registration was successful, you may close the utility.
</li><li> If the registration status shows that the process was unsuccessful, then an error log can be retrieved by selecting the enabled <b>Save Log...</b> button. Proceed to #troubleshooting Troubleshooting Registration Failures.
</li></ul>
</li></ol>
<a name="Registering_without_an_Installer"></a><h4> <span class="mw-headline"> Registering without an Installer </span></h4>
<p>You may opt to register your Spatial products without using an installer. The <b>Application</b> tab in the Spatial Registration Utility allows you to enter the same parameters as you would have with the registration function in an installer.
</p><p>Before you begin, ensure the following prerequisites:
</p>