| getvpnsessionactionResult Structure Definition |
The getvpnsessionactionResult structure defines the return type for getvpnsessionaction API. |
Syntax |
Members |
rc |
If the method succeeds, rc is 0 else rc > 0. Values above 0x8000 indicate Warnings. |
message |
If the method succeeds, message is NULL else message contains Error/Warning message. |
vpnsessionactionList |
List of vpnsessionactions |
| vpnsessionaction Structure Definition |
The vpnsessionaction structure defines the actual return type values for getvpnsessionaction API. |
Syntax |
Members |
name |
Name of the session action to display. |
useraccounting |
RADIUS policy to use for user accounting |
httpport |
The HTTP port for this session action |
winsip |
The WINS server IP address for this session action. |
dnsvservername |
The name of the DNS vserver configured by the session action. |
splitdns |
The VPN client SplitDns state. |
sesstimeout |
The session timeout, in minutes, set by the action. |
clientsecurity |
The client security check string being applied. This is in the form of an expression. Expressions are simple conditions, such as a test for equality, applied to operands, such as a URL string or an IP address. Expression syntax is described in the Installation and Configuration Guide. |
clientsecuritygroup |
The client security group that will be assigned on failure of the client security check. Users can in general be organized into Groups. In this case, the Client Security Group may have a more restrictive security policy. |
clientsecuritymessage |
The client security message that will be displayed on failure of the client security check. |
clientsecuritylog |
Set the logging of client security checks. |
splittunnel |
Send, through the tunnel, traffic only for intranet applications that are defined in Citrix Gateway. Route all other traffic directly to the Internet. The OFF setting routes all traffic through Citrix Gateway. With the REVERSE setting, intranet applications define the network traffic that is not intercepted. All network traffic directed to internal IP addresses bypasses the VPN tunnel, while other traffic goes through Citrix Gateway. Reverse split tunneling can be used to log all non-local LAN traffic. For example, if users have a home network and are logged on through the Citrix Gateway Plug-in, network traffic destined to a printer or another device within the home network is not intercepted. |
locallanaccess |
Set local LAN access. If split tunneling is OFF, and you set local LAN access to ON, the local client can route traffic to its local interface. When the local area network switch is specified, this combination of switches is useful. The client can allow local LAN access to devices that commonly have non-routable addresses, such as local printers or local file servers. |
rfc1918 |
As defined in the local area network, allow only the following local area network addresses to bypass the VPN tunnel when the local LAN access feature is enabled:
* 10.*.*.*,
* 172.16.*.*,
* 192.168.*.* |
spoofiip |
IP address that the intranet application uses to route the connection through the virtual adapter. NOTE: This attribute is deprecated. This argument is deprecated since snoofip is no longer supported. |
killconnections |
Specify whether the Citrix Gateway Plug-in should disconnect all preexisting connections, such as the connections existing before the user logged on to Citrix Gateway, and prevent new incoming connections on the Citrix Gateway Plug-in for Windows and MAC when the user is connected to Citrix Gateway and split tunneling is disabled. |
transparentinterception |
Allow access to network resources by using a single IP address and subnet mask or a range of IP addresses. The OFF setting sets the mode to proxy, in which you configure destination and source IP addresses and port numbers. If you are using the Citrix Gateway Plug-in for Windows, set this parameter to ON, in which the mode is set to transparent. If you are using the Citrix Gateway Plug-in for Java, set this parameter to OFF. |
windowsclienttype |
Windows client type, e.g. Agent or ActiveX NOTE: This attribute is deprecated. This argument is deprecated since ActiveX is no longer supported. |
defaultauthorizationaction |
The Authorization Action, e.g. allow or deny |
authorizationgroup |
The authorization group applied to client sessions. |
smartgroup |
This is the default group that is chosen when the authentication succeeds in addition to extracted groups. |
clientidletimeout |
The client idle timeout, in minutes. |
clientidletimeoutwarning |
The time after which the client gets a timeout warning, in minutes. |
proxy |
The state of proxy configuration for the session. |
allprotocolproxy |
The address set for all proxies. |
httpproxy |
The HTTP proxy IP address. |
ftpproxy |
The FTP proxy IP address. |
socksproxy |
IP address of the proxy server to be used for SOCKS access for all subsequent connections to the internal network. |
gopherproxy |
The Gopher proxy IP address. |
sslproxy |
The HTTPS proxy IP address. |
proxyexception |
Proxy exception string that will be configured in the browser for bypassing the previously configured proxies. Allowed only if proxy type is Browser. |
proxylocalbypass |
Bypass proxy server for local addresses option in Internet Explorer and Firefox proxy server settings. |
clientcleanupprompt |
Prompt for client-side cache clean-up when a client-initiated session closes. |
forcecleanup |
Force cache clean-up when the user closes a session. You can specify all, none, or any combination of the client-side items. |
clientoptions |
List of configured buttons(and/or menu options in the docked client) in the Windows VPN client. NOTE: This attribute is deprecated. This argument is deprecated . |
clientconfiguration |
List of configured tabs in the Windows VPN client. |
sso |
Whether or not Single Sign-On is used for this session. |
ssocredential |
Specify whether to use the primary or secondary authentication credentials for single sign-on to the server. |
windowsautologon |
Whether or not Windows Auto Logon is enabled for this session. |
usemip |
Whether or not a Mapped IP address is used for the session |
useiip |
Define IP address pool options. Available settings function as follows:
* SPILLOVER - When an address pool is configured and the mapped IP is used as an intranet IP address, the mapped IP address is used when an intranet IP address cannot be assigned.
* NOSPILLOVER - When intranet IP addresses are enabled and the mapped IP address is not used, the Transfer Login page appears for users who have used all available intranet IP addresses.
* OFF - Address pool is not configured. |
clientdebug |
Trace level on the Windows VPN Client. NOTE: This attribute is deprecated. This argument is deprecated . |
loginscript |
Path to the logon script that is run when a session is established. Separate multiple scripts by using comma. A "$" in the path signifies that the word following the "$" is an environment variable. |
logoutscript |
Path to the logout script. Separate multiple scripts by using comma. A "$" in the path signifies that the word following the "$" is an environment variable. |
homepage |
The client home page. |
icaproxy |
Enable ICA proxy to configure secure Internet access to servers running Citrix XenApp or XenDesktop by using Citrix Receiver instead of the Citrix Gateway Plug-in. |
wihome |
Web address of the Web Interface server, such as http:// |
wihomeaddresstype |
Type of the wihome address(IPV4/V6) |
citrixreceiverhome |
Web address for the Citrix Receiver home page. Configure Citrix Gateway so that when users log on to the appliance, the Citrix Gateway Plug-in opens a web browser that allows single sign-on to the Citrix Receiver home page. |
wiportalmode |
Layout on the Access Interface. The COMPACT value indicates the use of small icons. |
clientchoices |
Provide users with multiple logon options. With client choices, users have the option of logging on by using the Citrix Gateway Plug-in for Windows, Citrix Gateway Plug-in for Java, the Web Interface, or clientless access from one location. Depending on how Citrix Gateway is configured, users are presented with up to three icons for logon choices. The most common are the Citrix Gateway Plug-in for Windows, Web Interface, and clientless access. |
epaclienttype |
Choose between two types of End point Windows Client
a) Application Agent - which always runs in the task bar as a standalone application and also has a supporting service which runs permanently when installed
b) Activex Control - ActiveX control run by Microsoft Internet Explorer. NOTE: This attribute is deprecated. This argument is not supported |
iipdnssuffix |
The IntranetIP DNS suffix. |
forcedtimeout |
Force a disconnection from the Citrix Gateway Plug-in with Citrix Gateway after a specified number of minutes. If the session closes, the user must log on again. |
forcedtimeoutwarning |
Number of minutes to warn a user before the user session is disconnected. |
ntdomain |
Single sign-on domain to use for single sign-on to applications in the internal network. This setting can be overwritten by the domain that users specify at the time of logon or by the domain that the authentication server returns. |
clientlessvpnmode |
Whether clientlessVPN is available to the session. |
clientlessmodeurlencoding |
URL encoding used in clientless mode. |
clientlesspersistentcookie |
State of persistent cookies in clientless access mode. Persistent cookies are required for accessing certain features of SharePoint, such as opening and editing Microsoft Word, Excel, and PowerPoint documents hosted on the SharePoint server. A persistent cookie remains on the user device and is sent with each HTTP request. Citrix Gateway encrypts the persistent cookie before sending it to the plug-in on the user device, and refreshes the cookie periodically as long as the session exists. The cookie becomes stale if the session ends. Available settings function as follows:
* ALLOW - Enable persistent cookies. Users can open and edit Microsoft documents stored in SharePoint.
* DENY - Disable persistent cookies. Users cannot open and edit Microsoft documents stored in SharePoint.
* PROMPT - Prompt users to allow or deny persistent cookies during the session. Persistent cookies are not required for clientless access if users do not connect to SharePoint. |
emailhome |
The EMail home for the portal |
allowedlogingroups |
Specify groups that have permission to log on to Citrix Gateway. Users who do not belong to this group or groups are denied access even if they have valid credentials. |
securebrowse |
Allow users to connect through Citrix Gateway to network resources from iOS and Android mobile devices with Citrix Receiver. Users do not need to establish a full VPN tunnel to access resources in the secure network. |
storefronturl |
Web address for StoreFront to be used in this session for enumeration of resources from XenApp or XenDesktop. |
sfgatewayauthtype |
The authentication type configured for the Citrix Gateway on StoreFront. |
kcdaccount |
The kcd account details to be used in SSO |
rdpclientprofilename |
Name of the RDP profile associated with the vserver. |
builtin |
Indicates that a variable is a built-in (SYSTEM INTERNAL) type. |
windowspluginupgrade |
Option to set plugin upgrade behaviour for Win |
macpluginupgrade |
Option to set plugin upgrade behaviour for Mac |
linuxpluginupgrade |
Option to set plugin upgrade behaviour for Linux |
iconwithreceiver |
Option to decide whether to show plugin icon along with receiver |
alwaysonprofilename |
Name of the AlwaysON profile associated with the session action. The builtin profile named none can be used to explicitly disable AlwaysON for the session action. |
autoproxyurl |
URL to auto proxy config file |
advancedclientlessvpnmode |
Option to enable/disable Advanced ClientlessVpnMode. Additionaly, it can be set to STRICT to block Classic ClientlessVpnMode while in AdvancedClientlessMode. |
pcoipprofilename |
Name of the PCOIP profile associated with the session action. The builtin profile named none can be used to explicitly disable PCOIP for the session action. |
fqdnspoofedip |
Spoofed IP address range that can be used by client for FQDN based split tunneling |
netmask |
The netmask for the spoofed ip address |
_nextgenapiresource |
See Also |