OpenApplication

Displays the Open Application dialog box.

Before calling OpenApplication, you must set logon information by calling Logon or HsxClient.SetLogonInfo. The logon information that has been specified with the Logon dialog box or with SetLogonInfoSSO is authenticated after the user clicks the Open Application button.

Tip:

To open applications without displaying the Open Application dialog box, use HsxClient.OpenApplication.

Syntax

<HsxClientUI>.OpenApplication(ppIUnkServer, ppIUnkSession, pbstrServer, pbstrProduct, pbstrApplication)

Argument

Description

ppIUnkServer

HsxServer object. Returns an object reference to the HsxServer object for the application server that the user selects. For information on this object, see HsxServer Type Library.

ppIUnkSession

HsvSession object. Returns an object reference to an HsvSession object. For information on this object, see HsvSession Type Library.

pbstrServer

String. Returns the name of the application server that the user selects.

pbstrProduct

String. Returns the product name. “Financial Management” is returned for Financial Management applications.

pbstrApplication

String. Returns the name of the application that the user opens.

Return Value

Boolean. Returns TRUE if an application is opened, otherwise FALSE.

Example

This example uses the Logon method to display the Logon dialog box. If the user clicks the dialog box’s Logon button, Logon returns TRUE, and OpenApplication — which is placed within an If structure — is called. The example assumes that the m_cClientUI object reference has been set with the code in the Example for Initialize.

Dim cServer As HsxServer, cSession As HsvSession
Dim sServer As String, sProd As String, sApp As String
Dim bLogon As Boolean
bLogon = m_cClientUI.Logon(True)
If bLogon = True Then
  m_cClientUI.OpenApplication cServer, cSession, _ 
  sServer, sProd, sApp
End If