Table of Contents

Search

  1. Preface
  2. Introduction
  3. Program Design
  4. SSA-NAME3 Functions
  5. Language Specific Guidelines
  6. Controls
  7. Advanced Controls
  8. Address Standardization
  9. ASM Workbench

SSA-NAME3 API Reference Guide

SSA-NAME3 API Reference Guide

Calling from Visual Basic .NET

Calling from Visual Basic .NET

VB.NET programs should call the SSA-NAME3 DLL (
ssan3cs.dll
) as shown in the sample program. Further hints are provided below.
To use the
ssan3cs.dll
in a project being created in the Visual Studios.NET IDE, use the following steps as a guideline:
Add a reference to the
ssan3cs.dll
:
  • Right-click on the project/solution name in the
    Solution Explorer
    pane of the IDE. Select
    Add Reference...
  • Make sure that the
    .NET
    tab is the active tab. Use the
    Browse
    button to find ssan3cs.dll
  • Highlight the dll in the Explorer window and click
    Open
    .
  • This adds the
    ssan3cs.dll
    to the Selected Components pane of the
    Add Reference
    dialog. Click
    OK
    .
Add the
ssa
namespace to the project/solution:
  • Right-Click on the project/solution name in the
    Solution Explore
    pane of the IDE. Select
    Properties
    .
  • Click Imports under the
    Common Properties
    folder.
  • In the
    Namespace:
    textbox type
    ssa
    and click
    Add Import
    .
  • Click
    OK
    to exit.
Step 2 eliminates the need to have the following in any module:
Imports ssa
Otherwise, you can skip Step 2 and add the
Imports
statement as above.

Coding the ssan3_close Call outside of the Finalize() Method

Calling the
ssan3_close
method from a
Finalize()
method is not recommended. This is because it delays the call to
ssan3_close
until the runtime runs garbage collection on the released object, which can be anytime after the object has been released by the program.
Instead, it is recommended that the user implement a public cleanup or close method that performs the necessary housekeeping, including a call to
ssan3_close
to release open sessions prior to releasing the object.

0 COMMENTS

We’d like to hear from you!