This method sets options of the host session. Session options that are not set with this method use their default values. Session options set with this method remain in effect until another call sets a new value.
Namespace: JollyGiant.Emulation
Assembly: JGSComdotNet (in JGSComdotNet.dll) Version: 1.0.0.0 (1.0.0.0)
Syntax
| C# |
|---|
StatusCode SetSessionOptions( string options, ref int optionsLength ) |
| Visual Basic (Declaration) |
|---|
Function SetSessionOptions ( _ options As String, _ ByRef optionsLength As Integer _ ) As StatusCode |
| Visual C++ |
|---|
StatusCode SetSessionOptions( String^ options, int% optionsLength ) |
| JavaScript |
|---|
function SetSessionOptions(options, optionsLength); |
Parameters
options Type: System..::.StringString containing the desired session options to set. If more than one session option is set, use a comma or space to separate the session options.
optionsLength Type: System..::.Int32 %Explicit length of options string. Remains the same as the call value if all session options in the buffer are valid. If the options contain any invalid session options, optionsLength is set to the number of valid session options in options.
Return Value
The StatusCode indicating the result of the operation.This can be one of the following values:
| Status code | Description |
|---|---|
| Ok | All of the requested session options set as specified. |
| WHLLPARAMETERERROR | Data String contains one or more invalid session options. |
| WHLLSYSERROR | The method failed due to a system error. |
Remarks
See the HLLAPI help file for a detailed explanation on available session parameters and the methods they affect.
Examples
CopyC#
string options = "NOEAB TIMEOUT=4 QUIET AUTORESET"; int length = options.Length; IApplication app = qws.Application; if (Ok != app.SetSessionOptions(options, ref length) || length != options.Length) // not all options have been set reportError(code);
