Constants | |
enum | CommProfile_t { CommProfile_TCP = 0x00000000, CommProfile_HTTP = 0x00000001, CommProfile_UDP = 0x00000002, CommProfile_WebConnect = 0x00000003 } |
enum | SessionType_t { SessionType_RemoteControl = 0x00000001, SessionType_Chat = 0x00000004 } |
enum | MouseMode_t { MouseMode_Local = 0x00000000, MouseMode_Remote = 0x00000001, MouseMode_None = 0x00000002 } |
enum | KeyboardMode_t { KeyboardMode_Local = 0x00000000, KeyboardMode_Remote = 0x00000001, KeyboardMode_None = 0x00000002 } |
enum | StretchMode_t { Stretch_FitWindowToHost = 0x00000000, Stretch_FitHostToWindow = 0x00000001, Stretch_FitNone = 0x00000002 } |
enum | GraphicsMode_t { GraphicsMode_Hook = 0x00000000, GraphicsMode_AccBitmap = 0x00000001, GraphicsMode_NormalBitmap = 0x00000002 } |
enum | MaxColors_t { MaxColors_Actual = 0x00000000, MaxColors_256 = 0x00000001, MaxColors_16 = 0x00000002, MaxColors_2 = 0x00000003 } |
enum | CompressionLevel_t { CompressionLevel_Auto = 0x00000000, CompressionLevel_None = 0x00000001, CompressionLevel_Low = 0x00000002, CompressionLevel_High = 0x00000003 } |
enum | EncryptionLevel_t { EncryptionLevel_Compatible = 0x00000000, EncryptionLevel_None = 0x00000001, EncryptionLevel_DataIntegrity = 0x00000002, EncryptionLevel_Keyboard = 0x00000003, EncryptionLevel_DataIntegrityAndKeyboard = 0x00000004, EncryptionLevel_High = 0x00000005, EncryptionLevel_VeryHigh = 0x00000006 } |
enum | DesktopOptimization_t { DesktopOptimization_DisableEverything = 0x00000001, DesktopOptimization_DisableWallpaper = 0x00000002, DesktopOptimization_DisableScreenSaver = 0x00000004, DesktopOptimization_DisableAnimation = 0x00000008, DesktopOptimization_DisableFullWindowDrag = 0x00000010, DesktopOptimization_DisableMenuAnimation = 0x00000020, DesktopOptimization_DisableComboboxAnimation = 0x00000040, DesktopOptimization_DisableSmoothScrolling = 0x00000080, DesktopOptimization_DisableGradientCaption = 0x00000100, DesktopOptimization_DisableActiveDesktop = 0x00000200, DesktopOptimization_DisableMenuFade = 0x00000400, DesktopOptimization_DisableSelectionFade = 0x00000800, DesktopOptimization_DisableTooltipFade = 0x00001000, DesktopOptimization_DisableMenuDropShadowEffect = 0x00002000, DesktopOptimization_DisableFontSmoothing = 0x00004000, DesktopOptimization_DisableVistaAero = 0x00008000, DesktopOptimization_DisableOverlappedContent = 0x00010000, DesktopOptimization_DisableVistaAnimations = 0x00020000 } |
enum | Language_t { Language_English = 1033, Language_French = 1036, Language_German = 1031, Language_Spanish = 1034 } |
enum | LicenseType_t { LicenseType_None = 0x00000000, LicenseType_Network = 0x00000001, LicenseType_Standalone = 0x00000002, LicenseType_File = 0x00000003 } |
enum | { NGA_UNKNOWN = -1 } |
enum | MultiguestEvent_t { MultiguestEvent_InputAssigned = 0x00000001, MultiguestEvent_InputRevoked = 0x00000002, MultiguestEvent_InputDenied = 0x00000004, MultiguestEvent_ConnectionsChanged = 0x00000008, MultiguestEvent_MultiSessionsSuspended = 0x00000010, MultiguestEvent_MultiSessionsAllowed = 0x00000020, MultiguestEvent_MultiSessionsDeninied = 0x00000040 } |
enum | SessionStatus_t { SessionStatus_Idle = 0, SessionStatus_Connecting = 1, SessionStatus_Opening = 2, SessionStatus_Authenticating = 3, SessionStatus_Starting = 4, SessionStatus_Running = 5, SessionStatus_Closing = 6 } |
enum | InfoWindowReason_t { InfoWindowReason_Connecting = 1, InfoWindowReason_Connected = 2, InfoWindowReason_CancelLogin = 3, InfoWindowReason_Disconnecting = 4, InfoWindowReason_Closing = 5 } |
enum | ErrorCode_t { NGA_OK = 0x0000000, NGA_ERROR = 0x0000001, NGA_ERR_BASE = 0x0001000, NGA_ERR_INVALID_PARAMETER, NGA_ERR_INVALID_STATUS, NGA_ERR_NOT_OPENED, NGA_ERR_PERMISSION_DENIED, NGA_ERR_NO_SESSION } |
Current connection properties | |
LONG | CurrentCommProfile [get] |
BSTR | CurrentHostAddress [get] |
LONG | CurrentPortNumber [get] |
BSTR | CurrentGatewayAddress [get] |
BSTR | CurrentHttpProxyAddress [get] |
LONG | CurrentGraphicsMode [get] |
LONG | CurrentGraphicsMaxColors [get, set] |
LONG | CurrentCompressionLevel [get, set] |
LONG | CurrentEncryptionPreferred [get] |
VARIANT_BOOL | IsOpen [get] |
VARIANT_BOOL | IsConnected [get] |
LONG | SessionStatus [get] |
LONG | HostScreenWidth [get] |
LONG | HostScreenHeight [get] |
VARIANT_BOOL | IsMultiguestAdminOnHost [get] |
LONG | NumGuestsOnHost [get] |
INGuestXFont | ChatFont [get] |
Properties for next connection | |
New values for these properties are not used until next connection. | |
LONG | CommProfile [get, set] |
BSTR | HostAddress [get, set] |
LONG | PortNumber [get, set] |
BSTR | GatewayAddress [get, set] |
BSTR | HttpProxyAddress [get, set] |
LONG | CompressionLevel [get, set] |
LONG | EncryptionPreferred [get, set] |
LONG | GraphicsMode [get, set] |
LONG | GraphicsMaxColors [get, set] |
VARIANT_BOOL | LockHostKeyboardOnConnect [get, set] |
VARIANT_BOOL | BlankHostScreenOnConnect [get, set] |
VARIANT_BOOL | GuardHostOnConnect [get, set] |
Remote desktop display properties | |
LONG | DesktopOptimizeMask [get, set] |
LONG | StretchToFitWindow [get, set] |
VARIANT_BOOL | AutoScroll [get, set] |
LONG | ScrollPositionX [get, set] |
LONG | ScrollPositionY [get, set] |
INGuestXRcArea | RcArea [get] |
Keyboard and mouse properties | |
LONG | MouseMode [get, set] |
VARIANT_BOOL | ShowRemoteMouseMovements [get, set] |
LONG | KeyboardMode [get, set] |
VARIANT_BOOL | UnicodeKeyboardMode [get, set] |
VARIANT_BOOL | RemoteCursor [get, set] |
VARIANT_BOOL | AutoTakeControl [get, set] |
Localization properties | |
LONG | Language [get, set] |
License properties | |
LONG | LicenseType [get, set] |
BSTR | LicenseKey [get, set] |
BSTR | LicenseServer [get, set] |
BSTR | LicenseFile [get, set] |
VARIANT_BOOL | LicenseAutoSave [get, set] |
WebConnect properties | |
BSTR | WebConnectAddress [get, set] |
BSTR | WebConnectCredentialsAccount [get, set] |
BSTR | WebConnectCredentialsPassword [get, set] |
BSTR | WebConnectCredentialsDomain [get, set] |
BSTR | WebConnectProvidedTicket [get, set] |
BSTR | WebConnectNameQualifier [get, set] |
Public Member Functions | |
HRESULT | Open ([out, retval] LONG *result) |
HRESULT | Close ([out, retval] LONG *result) |
HRESULT | BeginSession ([in] LONG SessionType,[out, retval] LONG *result) |
HRESULT | EndSession ([in] LONG SessionType,[out, retval] LONG *result) |
HRESULT | SendLoginPassword ([in] BSTR Pwd,[out, retval] LONG *result) |
HRESULT | SendLoginNetOp ([in] BSTR GuestId,[in] BSTR Pwd,[in] BSTR NewPassword,[out, retval] LONG *result) |
HRESULT | SendLoginWindows ([in] BSTR UserId,[in] BSTR Domain,[in] BSTR Pwd,[out, retval] LONG *result) |
HRESULT | SendLoginLdap ([in] BSTR Server,[in] BSTR User,[in] BSTR Pwd,[out, retval] LONG *result) |
HRESULT | SendLoginRsa ([in] BSTR UserId,[in] BSTR Pco,[in] BSTR Pwd,[in] BSTR NewPassword,[out, retval] LONG *result) |
HRESULT | SendLoginRsaPin ([in] BSTR Pin,[out, retval] LONG *result) |
HRESULT | CancelLogin ([out, retval] LONG *result) |
HRESULT | SendRefreshScreen ([out, retval] LONG *result) |
HRESULT | SendCtrlAltDel ([out, retval] LONG *result) |
HRESULT | SendCtrlEsc ([out, retval] LONG *result) |
HRESULT | SendAltTab ([in] VARIANT_BOOL bSendAltUp,[out, retval] LONG *result) |
HRESULT | SendAltShiftTab ([in] VARIANT_BOOL bSendAltUp,[out, retval] LONG *result) |
HRESULT | SendAltUp ([out, retval] LONG *result) |
HRESULT | SendGoSolo ([out, retval] LONG *result) |
HRESULT | RequestKeyboardAndMouseControl ([out, retval] LONG *result) |
HRESULT | SendGuardHost ([in] VARIANT_BOOL Guard,[out, retval] LONG *result) |
HRESULT | SendChatMessage ([in] BSTR Message,[out, retval] LONG *result) |
HRESULT | SetCustomString ([in] LONG StringId,[in] BSTR Str,[out, retval] LONG *result) |
HRESULT | GetKeyboardShortcut ([in] LONG ShortcutType,[out, retval] INGuestXShortcut **result) |
The connection encryption level.
The remote desktop optimization flags.
Multi guest event flags.
Session status.
Info window reason.
Error codes.
HRESULT INGuestXCtrl::Open | ( | [out, retval] LONG * | result | ) |
Opens NGA control instance.
Opens NGA control instance and change IsOpen property if opened successfully. Instance should be open to create sessions.
This method is synchronous.
The method fires the following events:
NGuestXLib::_INGuestXCtrlEvents::OnOpenPre event is always followed by NGuestXLib::_INGuestXCtrlEvents::OnOpenPost() event.
The events are not fired if the instance is already opened.
HRESULT INGuestXCtrl::Close | ( | [out, retval] LONG * | result | ) |
Close NGA control instance.
Ends all active sessions, disconnects from the host, close the NGA control instance and change IsOpen property if closed successfully.
This method is synchronous.
The method fires the following events:
NGuestXLib::_INGuestXCtrlEvents::OnClosePre event is always followed by NGuestXLib::_INGuestXCtrlEvents::OnClosePost() event.
The events are not fired if the instance is already closed.
After having the Close() method called, the Open() method can be called once again.
This method is called automatically when ActiveX window is being destroyed.
HRESULT INGuestXCtrl::BeginSession | ( | [in] LONG | SessionType, | |
[out, retval] LONG * | result | |||
) |
Initiates a new session.
This function can be used to start a chat session or to resume an RC session when the connection is active or to start a new connection with chat or RC session.
When there is no active connection, the new connection will be established with a host specified by HostAddress, PortNumber, GatewayAddress, HttpProxyAddress, CommProfile properties.
If there is already an active connection, this function either opens a new chat session or resumes an RC session.
The function is asynchronous. The following events can be fired during and after calling this method:
NGuestXLib::_INGuestXCtrlEvents::OnConnectPre(), NGuestXLib::_INGuestXCtrlEvents::OnConnectPost() and NGuestXLib::_INGuestXCtrlEvents::OnSessionStarted() are fired only when a new connection is established.
When there was an active connection, only NGuestXLib::_INGuestXCtrlEvents::OnBeginSessionPre() and NGuestXLib::_INGuestXCtrlEvents::OnBeginSessionPost() events are fired.
NGuestXLib::_INGuestXCtrlEvents::OnConnectPre() is always followed by NGuestXLib::_INGuestXCtrlEvents::OnConnectPost().
There is always NGuestXLib::_INGuestXCtrlEvents::OnBeginSessionPost() for each NGuestXLib::INGuestXCtrlEvents::OnBeginSessionPre().
None of these event may be produced if the BeginSession() returns an error.
It is safe to call this function only in some particular states:
In other cases such as when a connection is closing, or when a connection is starting, or when Host requested authentication this function will return an error.
For example in the following code:
nga->Open(); nga->BeginSession(Rc); nga->BeginSession(Chat);
SessionType | - a session to open:
|
HRESULT INGuestXCtrl::EndSession | ( | [in] LONG | SessionType, | |
[out, retval] LONG * | result | |||
) |
Ends an active session of the given type.
If there is no more active session, this function disconnects the NGA instance from Host.
The function is asynchronous. The following events can be produced after calling this method:
NGuestXLib::_INGuestXCtrlEvents::OnDisconnectPre() and NGuestXLib::_INGuestXCtrlEvents::OnDisconnectPost() are fired only when the instance is disconnected from Host.
When there is still an active connection, only NGuestXLib::_INGuestXCtrlEvents::OnEndSessionPre() and NGuestXLib::_INGuestXCtrlEvents::OnEndSessionPost() events are fired.
NGuestXLib::_INGuestXCtrlEvents::OnDisconnectPre() is always followed by NGuestXLib::_INGuestXCtrlEvents::OnDisconnectPost().
There is always NGuestXLib::_INGuestXCtrlEvents::OnEndSessionPost() for each NGuestXLib::INGuestXCtrlEvents::OnEndSessionPre().
None of these event can be produced if the function returns an error.
It is safe to call this function only in some particular states:
In other states (e.g. connecting, closing) the function will return an error.
For example in the following code:
// nga is not connected yet if (nga->BeginSession(Rc) == 0) // start new connection nga->EndSession(Rc)
SessionType | - a session to open
|
HRESULT INGuestXCtrl::SendLoginPassword | ( | [in] BSTR | Pwd, | |
[out, retval] LONG * | result | |||
) |
Sends the password credentials to Host.
This function shall only be called on NGuestXLib::_INGuestXCtrlEvents::OnLoginPassword() event.
The function is asynchronous.
Pwd | - The password must not be NULL and not longer than 16 characters. |
HRESULT INGuestXCtrl::SendLoginNetOp | ( | [in] BSTR | GuestId, | |
[in] BSTR | Pwd, | |||
[in] BSTR | NewPassword, | |||
[out, retval] LONG * | result | |||
) |
Sends the NetOp credentials to Host.
This function shall only be called on NGuestXLib::_INGuestXCtrlEvents::OnLoginNetop() event.
The function is asynchronous.
GuestId | - The user ID must not be NULL and not longer than 32 characters. | |
Pwd | - The password must not be NULL and not longer than 16 characters. |
HRESULT INGuestXCtrl::SendLoginWindows | ( | [in] BSTR | UserId, | |
[in] BSTR | Domain, | |||
[in] BSTR | Pwd, | |||
[out, retval] LONG * | result | |||
) |
Sends Windows system credentials to Host.
This function shall only be called on NGuestXLib::_INGuestXCtrlEvents::OnLoginNetOp() event.
The function is asynchronous.
UserId | - The user ID must not be NULL and not longer than 512 characters. | |
Domain | - The domain must not be NULL and not longer than 512 characters. | |
Pwd | - The password must not be NULL and not longer than 512 characters. |
HRESULT INGuestXCtrl::SendLoginLdap | ( | [in] BSTR | Server, | |
[in] BSTR | User, | |||
[in] BSTR | Pwd, | |||
[out, retval] LONG * | result | |||
) |
Sends LDAP credentials to Host.
This shall only be called on NGuestXLib::_INGuestXCtrlEvents::OnLoginLdap() event.
The function is asynchronous.
Server | - The server ID must not be NULL and not longer than 512 characters. | |
User | - The user ID must not be NULL and not longer than 512 characters. | |
Pwd | - The password must not be NULL and not longer than 512 characters. |
HRESULT INGuestXCtrl::SendLoginRsa | ( | [in] BSTR | UserId, | |
[in] BSTR | Pco, | |||
[in] BSTR | Pwd, | |||
[in] BSTR | NewPassword, | |||
[out, retval] LONG * | result | |||
) |
Sends RSA credentials to Host.
This function shall only be called on NGuestXLib::_INGuestXCtrlEvents::OnLoginRsa() event.
The function is asynchronous.
UserId | - The user ID must not be NULL and not longer than 32 characters. | |
Pco | - The RSA SecurID passcode must not be NULL and not longer than 16 characters. | |
Pwd | - The optional password. May be be NULL. Must not be longer then 16 chars. |
HRESULT INGuestXCtrl::SendLoginRsaPin | ( | [in] BSTR | Pin, | |
[out, retval] LONG * | result | |||
) |
Sends RSA SecurID pin code to Host.
Sends an RSA SecurID pin code. This shall only be called on NGuestXLib::_INGuestXCtrlEvents::OnEnterRsaPincode() event.
The function is asynchronous.
Pin | - The pin code. |
HRESULT INGuestXCtrl::CancelLogin | ( | [out, retval] LONG * | result | ) |
Cancels the authentication on a Gateway or Host.
Can be used to cancel the authentication on a gateway or host. When canceling the authentication on Host, the NGuestXLib::_INGuestXCtrlEvents::OnLoginFailed() is fired.
This funciton should be called on in response to OnLogin events:
HRESULT INGuestXCtrl::SendRefreshScreen | ( | [out, retval] LONG * | result | ) |
Forces the Host to resend its screen.
This function forcefully refreshes RC screen.
HRESULT INGuestXCtrl::SendCtrlAltDel | ( | [out, retval] LONG * | result | ) |
Sends Ctrl-Alt-Del keystroke to Host.
This function sends both key down and up scancodes.
HRESULT INGuestXCtrl::SendCtrlEsc | ( | [out, retval] LONG * | result | ) |
Sends Ctrl-Esc keystroke to Host.
This function sends both down and up scancodes.
HRESULT INGuestXCtrl::SendAltTab | ( | [in] VARIANT_BOOL | bSendAltUp, | |
[out, retval] LONG * | result | |||
) |
Sends Alt+Tab keystroke to Host.
Function sends scancodes for Alt-Tab key down and key up. To prevent the funcitn from sending Alt key up scancode the bSendAltUp parameter can be set to FALSE.
bSendAltUp | - when false the function do not send Alt up scancode. |
HRESULT INGuestXCtrl::SendAltShiftTab | ( | [in] VARIANT_BOOL | bSendAltUp, | |
[out, retval] LONG * | result | |||
) |
Sends Alt-Shift-Tab keystroke to Host.
Function sends scancodes for Alt-Shift-Tab key down and key up. To prevent the function from sending Alt key up scancode the bSendAltUp parameter can be set to FALSE.
UpDown | - If TRUE, send down+up scancodes, otherwise only down. |
HRESULT INGuestXCtrl::SendAltUp | ( | [out, retval] LONG * | result | ) |
Sends Alt key up scan code to Host.
This function can be use to send a key up scan code for Alt button to Host when the Alt up scan code was not sent by SendAltTab() or SendAltShiftTab().
HRESULT INGuestXCtrl::SendGoSolo | ( | [out, retval] LONG * | result | ) |
Sends the Go Solo command to Host.
HRESULT INGuestXCtrl::RequestKeyboardAndMouseControl | ( | [out, retval] LONG * | result | ) |
Sends Request Keyboard And Mouse Control command to Host.
HRESULT INGuestXCtrl::SendGuardHost | ( | [in] VARIANT_BOOL | Guard, | |
[out, retval] LONG * | result | |||
) |
Sends Guard command to Host.
Guard | true - to prevent further guest connections false - to enable further guest connections |
HRESULT INGuestXCtrl::SendChatMessage | ( | [in] BSTR | Message, | |
[out, retval] LONG * | result | |||
) |
Sends chat message to Host.
Message | - a chat message to send to host. | |
Font | - a font of chat message |
HRESULT INGuestXCtrl::SetCustomString | ( | [in] LONG | StringId, | |
[in] BSTR | Str, | |||
[out, retval] LONG * | result | |||
) |
Overrides the given GUI string.
StringId | - The Id of GUI string to override. | |
Str | - New GUI string. Passing a NULL string will remove the overridden string. |
HRESULT INGuestXCtrl::GetKeyboardShortcut | ( | [in] LONG | ShortcutType, | |
[out, retval] INGuestXShortcut ** | result | |||
) |
Keyboard shortcut interface.
This method can be used to set/get ActiveX keyboard shortcuts, for example "Send Alt-Ctrl-Del to Host", "Send Ctrl-Esc to Host", etc.
ShortcutType | - the ID of the shortcut to return (one of the INGuestXShortcut::ShortcutType_t constants) |
LONG INGuestXCtrl::CurrentCommProfile [get] |
The communication profile of the current connection, read only.
When there is no active connection the NGA_UNKNOWN is always returned.
BSTR INGuestXCtrl::CurrentHostAddress [get] |
The host address of the current connection, read only.
When there is no connection the empty string is returned.
LONG INGuestXCtrl::CurrentPortNumber [get] |
The port number of the current connection, read only.
The value 0 means that default port for current communication profile should is used.
When there is no active connection NGA_UNKNOWN is returned.
BSTR INGuestXCtrl::CurrentGatewayAddress [get] |
The address of the gateway for the current connection, read only.
When there is no active connection the empty string is returned.
BSTR INGuestXCtrl::CurrentHttpProxyAddress [get] |
The address of HTTP proxy for the current connection, read only.
When there is no connection the empty string is returned.
LONG INGuestXCtrl::CurrentGraphicsMode [get] |
The graphic mode of the current connection, read only.
One of the GraphicsMode_t constant can be assigned to this property.
When there is no active connection the NGA_UNKNOWN is returned.
LONG INGuestXCtrl::CurrentGraphicsMaxColors [get, set] |
The limit of bitmap mode colors for the current connection, read/write.
One of the MaxColors_t constant can be assigned to this property.
Used only for bitmap modes (e.g. when GraphicsMode property is either GraphicsMode_AccBitmap or GraphicsMode_NormalBitmap).
When there is no active connection the NGA_UNKNOWN is returned.
LONG INGuestXCtrl::CurrentCompressionLevel [get, set] |
The compression level of the current connection, read/write.
One of the CompressionLevel_t constants can be assigned to this property.
When there is no active connection the NGA_UNKNOWN is returned.
LONG INGuestXCtrl::CurrentEncryptionPreferred [get] |
The encryption level of the current connection, read/write.
One of the EncryptionLevel_t constants can be assigned to this property.
When there is no active connection the NGA_UNKNOWN is returned.
VARIANT_BOOL INGuestXCtrl::IsOpen [get] |
Whether the instance of NGA was opened successfully by Open() function, read only.
VARIANT_BOOL INGuestXCtrl::IsConnected [get] |
Whether the instance of NGA is connected to remote Host, read only.
Property is true when there is an active session (chat or RC).
LONG INGuestXCtrl::SessionStatus [get] |
Current status of RC session, read only.
Status: Can be one of the SessionStatus_t constants. When the NGA instance is not open, status is SessionStatus_Idle.
LONG INGuestXCtrl::HostScreenWidth [get] |
The current width of the remote desktop, read only.
When there is no active RC session the NGA_UNKNOWN is returned.
LONG INGuestXCtrl::HostScreenHeight [get] |
The current height of the remote desktop, read only.
When there is no active RC session the NGA_UNKNOWN is returned.
VARIANT_BOOL INGuestXCtrl::IsMultiguestAdminOnHost [get] |
Whether the current RC session has multi guest admin role on Host, read only.
When there is no active session the false is returned.
LONG INGuestXCtrl::NumGuestsOnHost [get] |
The number of guests connected to Host, read only.
When there is no active session the NGA_UNKNOWN is returned.
INGuestXFont INGuestXCtrl::ChatFont [get] |
Get chat font interface, read only.
LONG INGuestXCtrl::CommProfile [get, set] |
Communication profile for a next connection.
One of the CommProfile_t constants can be assigned to this property.
Default value: CommProfile_TCP
BeginSession() method use this profile when establishing a new connection.
BSTR INGuestXCtrl::HostAddress [get, set] |
The address of remote host for a next connection.
BeginSession() method uses this address when establishing a new connection. Default value: empty string
LONG INGuestXCtrl::PortNumber [get, set] |
Port number for a next connection.
The value 0 means that default port for current communication profile should be used.
BeginSession() method use this property when establishing a new connection. Default value: 0
BSTR INGuestXCtrl::GatewayAddress [get, set] |
Address of gateway for a next connection.
When empty string is specified the gateway is not used. This property is ignored when UDP communication profile is selected.
BeginSession() method use this address when establishing a new connection. Default value: empty string
BSTR INGuestXCtrl::HttpProxyAddress [get, set] |
Address of HTTP proxy for a next connection.
The proxy address is ignored when UDP or TCP communication profile is selected.
BeginSession() method use this address when establishing a new connection. Default value: empty string
LONG INGuestXCtrl::CompressionLevel [get, set] |
The compression level for a next connection.
One of the CompressionLevel_t constants can be assigned to this property.
BeginSession() method uses this mode when establishing a new connection.
Default value: CompressionLevel_Auto - select compression level automatically
LONG INGuestXCtrl::EncryptionPreferred [get, set] |
The encryption level for a next connection.
One of the EncryptionLevel_t constants can be assigned to this property.
BeginSession() method uses this mode when establishing a new connection.
Default value: EncryptionLevel_Compatible - NetOp 6.5 compartible encryption
LONG INGuestXCtrl::GraphicsMode [get, set] |
The graphic mode for a next connection.
One of the GraphicsMode_t constant can be assigned to this property.
BeginSession() method use this mode when establishing a new connection.
LONG INGuestXCtrl::GraphicsMaxColors [get, set] |
The limit of bitmap mode colors for a next connection.
One of the MaxColors_t constant can be assigned to this property.
Used only for bitmap modes (e.g. when GraphicsMode property is either GraphicsMode_AccBitmap or GraphicsMode_NormalBitmap).
BeginSession() method uses this mode when establishing a new connection.
Default value: MaxColors_Actual - use actual colors
VARIANT_BOOL INGuestXCtrl::LockHostKeyboardOnConnect [get, set] |
Keyboard locking mode for a next connection.
BeginSession() method uses this mode when establishing a new connection.
Default value: FALSE (do not lock)
VARIANT_BOOL INGuestXCtrl::BlankHostScreenOnConnect [get, set] |
Host screen blanking mode for a next connection.
BeginSession() method uses this mode when establishing a new connection.
Default value: FALSE (do not blank)
VARIANT_BOOL INGuestXCtrl::GuardHostOnConnect [get, set] |
Host guard settings for a next connection.
BeginSession() method uses this mode when establishing a new connection.
Default value: FALSE (do not guard)
LONG INGuestXCtrl::DesktopOptimizeMask [get, set] |
Desktop optimization mask for the current and next connection.
A bitwise OR of the DesktopOptimization_t constants can be assigned to this property.
Changing this property will affect current RC session immediately. Same setting will be used for next RC session.
Default value: DesktopOptimization_DisableEverything - disable everything
LONG INGuestXCtrl::StretchToFitWindow [get, set] |
Remote desktop stretch mode.
Property indicate how the remote desktop image is displayed inside NGA control. Changing this property with active RC session will redraw the NGA control.
One of the StretchMode_t constants can be assigned to this property.
Default value: Stretch_FitWindowToHost
VARIANT_BOOL INGuestXCtrl::AutoScroll [get, set] |
Auto scroll mode.
The scroll is done when the Mouse enters a hot zone close to the border (1/10 of the width or height in each side (left/right/top/bottom) of the RC window.
Default value: TRUE (enabled).
LONG INGuestXCtrl::ScrollPositionX [get, set] |
The horizontal position of the remote desktop image inside NGA control.
Default value: 0
LONG INGuestXCtrl::ScrollPositionY [get, set] |
The vertical position of the remote desktop image inside NGA control.
Default value: 0
INGuestXRcArea INGuestXCtrl::RcArea [get] |
Rc area interface (read only property).
This property can be used to set/get the remote control area to be shown in the control. Changing this property does not affect the remote control area of the current connection, settings will be used for next connections.
See INGuestXRcArea interface description for more details.
LONG INGuestXCtrl::MouseMode [get, set] |
Mouse mode of current and next RC session.
One of the MouseMode_t constants can be assigned to this property.
Default value: MouseMode_Remote
VARIANT_BOOL INGuestXCtrl::ShowRemoteMouseMovements [get, set] |
Gets or sets the value of remote mouse movements property.
When this property is true the remote desktop mouse movements are shown when the control is focused.
Default value: false (do not show remote mouse movements)
LONG INGuestXCtrl::KeyboardMode [get, set] |
The keyboard mode of the current and next RC session.
One of the KeyboardMode_t constants can be assigned to this property.
Default value: KeyboardMode_Local
VARIANT_BOOL INGuestXCtrl::UnicodeKeyboardMode [get, set] |
Indicates whether keyboard events will be sent as unicode characters or as scan codes.
VARIANT_BOOL INGuestXCtrl::RemoteCursor [get, set] |
The remote cursor display mode.
When 'true' NGA mouse cursor have the shape of the Host mouse cursor when displayed in the NGA control. The shape of the cursor is not stretched when the remote desktop mode is stretched to fit the screen.
Default value: true
VARIANT_BOOL INGuestXCtrl::AutoTakeControl [get, set] |
Gets or sets the auto take control property.
When several guests are connected to the same host only one of these guests controls Host's keyboard and mouse. When this option is enabled, Guest requests the control over Host keyboard and mouse automatically on keyboard or mouse hit.
Default value: true
LONG INGuestXCtrl::Language [get, set] |
Gets or sets the language used for build-in dialogs.
One of the Language_t constants can be assigned to this property.
When attempting to assign unsupported language value, the current UI language is not changed.
Default value: selected in accordance with system locale. If the current system locale is not supported, the Language_English language is used.
LONG INGuestXCtrl::LicenseType [get, set] |
Sentinel license type (network, standalone, etc).
One of the LicenseType_t constants can be assigned to this property.
When attempting to assign unsupported license type value, the current License type is not changed.
Default value: LicenseType_None
BSTR INGuestXCtrl::LicenseKey [get, set] |
The Sentinel license key.
ActiveX uses this property when the license type is standalone. The string property contains the license key (not the file name).
Default value: empty string
BSTR INGuestXCtrl::LicenseServer [get, set] |
The IP/hostname of the Sentinel license server.
ActiveX uses this property when the License Type is network.
Default value: empty string
BSTR INGuestXCtrl::LicenseFile [get, set] |
The Sentinel license file.
ActiveX uses this property when the license type is standalone file. The string property contains the full path to the license file.
Default value: empty string
VARIANT_BOOL INGuestXCtrl::LicenseAutoSave [get, set] |
The Sentinel license properties autosave flag.
ActiveX checks this property when some license property is changed and if flag is TRUE property value is saved into registry. The setting of this flag affects only properties changed after flag was set.
Default value: TRUE
BSTR INGuestXCtrl::WebConnectAddress [get, set] |
Gets or sets the WebConnect address for a next connection.
This property is ignored when communication profile other than WebConnect is selected.
BeginSession() method use this address when establishing a new connection. Default value: empty string
BSTR INGuestXCtrl::WebConnectCredentialsAccount [get, set] |
Gets or sets the WebConnect credentials account for a next connection.
This property is ignored when communication profile other than WebConnect is selected.
BeginSession() method use this address when establishing a new connection. Default value: empty string
BSTR INGuestXCtrl::WebConnectCredentialsPassword [get, set] |
Gets or sets the WebConnect credentials password for a next connection.
This property is ignored when communication profile other than WebConnect is selected.
BeginSession() method use this address when establishing a new connection. Default value: empty string
BSTR INGuestXCtrl::WebConnectCredentialsDomain [get, set] |
Gets or sets the WebConnect credentials domain for a next connection.
This property is ignored when communication profile other than WebConnect is selected.
BeginSession() method use this address when establishing a new connection. Default value: empty string
BSTR INGuestXCtrl::WebConnectProvidedTicket [get, set] |
Gets or sets the WebConnect provided ticket for next connection.
This property is ignored when communication profile other than WebConnect is selected.
BeginSession() method use this address when establishing a new connection. Default value: empty string
BSTR INGuestXCtrl::WebConnectNameQualifier [get, set] |
Gets or sets the WebConnect name qualifier for next connection.
This property is ignored when communication profile other than WebConnect is selected.
BeginSession() method use this address when establishing a new connection. Default value: "HST"