requestScreen Method

Gets a Screen object for the specified Management and Control Server (MCS) configuration using the specified userid and password as well as the named configuration.

Syntax

C#
Visual Basic
C++/CLI

'Declaration
 
Public Function requestScreen( _ 
   ByVal userid As String, _ 
   ByVal password As String, _ 
   ByVal config As String _ 
) As ScreenUPG

'Usage
 
Dim instance As SessionLoader 
Dim userid As String 
Dim password As String 
Dim config As String 
Dim value As ScreenUPG 
  
value = instance.requestScreen(userid, password, config)

public ScreenUPG requestScreen( 
   string userid,
   string password,
   string config 
)

public: 
ScreenUPG^ requestScreen( 
   String^ userid,
   String^ password,
   String^ config 
)

Parameters

userid: A valid user name defined in MCS. The user must have Management console access permission.
password: The password assigned to the user specified with the userid parameter.
config: A valid configuration defined in MCS for the user.

Return Value

A ScreenUPG

Exceptions

Exception	Description
SessionException	Thrown if the requested session could not be loaded.

Example

C#
Visual Basic

SessionLoader sl = new SessionLoader();
ScreenUPG screen;
            
try
{
	screen = sl.requestScreen("your_userid", "your_password", "your_config");
}
catch (SessionException se)
{
	// Unable to load MCS configuration
	System.out.println(se.getMessage());
}

Dim sl As SessionLoader.SessionLoader
Dim screen as ScreenUPG.ScreenUPG
            
On error resume next
            
'Get the SessionLoader
Set sl = CreateObject("SessionLoader.SessionLoader")
            
'Get the screen object from the specified MCS configuration
Set screen = sl.requestScreen("your_userid", "your_password", "your_config")

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

SessionLoader Class
SessionLoader Members
requestScreenEx Method