How to Establish a PCoIP Session¶
Before you can establish a PCoIP session with a host desktop, gather the following host desktop details:
- IP Address
- Port number
- Session ID
- Server name indication (SNI)
- Connection tag
This information can then be passed to the provided in-session client to establish a
PCoIP session programmatically. See the example code for specific call syntax.
In terms of programming interface, there are two ways that the connection and security
information can be presented to ClientSession.app
:
-
Pass the pieces of Information Individually to the Executable The following command invokes
ClientSession.app
to establish a PCoIP session and passes the connection and session information as parameters, where:- Connection tag:
SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA
- IP address:
10.64.60.115
- Session ID:
2305843009213693961
- Encode all information into a string container (URI) and then pass to the executable The following command invokesclient_session.exe -i connect-tag= SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC 8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA address=10.64.60.115 session-id=2305843009213693961
ClientSession.app
to establish a PCoIP session and passes the connection tag as a parameter and a URI encapsulating the IP address and Session ID in a string container, where: - Connection tag:
-
Connection Tag:
SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA
- URI: "teradici-pcoip://10.64.60.115:4172?sessionid= 230584300921369396"
URI Format Documentation
There is a document describing the URI format in the root of the SDK,
client_session connecttag= SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4A V1FC8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA "teradicipcoip:// 10.64.60.115:4172?session-id=230584300921369396"