Share this page

# pcoip_connect

Connects to the remote desktop.

## C Language

int pcoip_connect( const char* hostname, const char* ip_addr, const char* sni, const char* port );

Example | Teradici PCoIP Protocol Functions

## Arguments

Name | Comments
--- | ---
hostname | The server.
ip_addr | The address of the server.
sni | The Server Name Indication of the target PCoIP server.
port | The server port.

## General Information

pcoip_connect connects to the remote desktop. Before calling pcoip_connect, set the credentials with pcoip_set_auth.

## Return Values

E_OK |
E_ALREADY_CONNECTED | Do not call this function after the connection is established.
E_NOT_CONNECTED | Action cannot be performed. There is no connection to the remote server.
E_OUT_OF_TIME | Function timed out.
E_ILLEGAL_PARAMETER | Illegal parameter found.
E_INTERNAL | Internal error found.

## Parameterization

The hostname, ip_addr, sni, and port arguments can be parameterized.

## Example

This example shows a connection and disconnection.

    	pcoip_set_broker_address("mybroker.com", "443");

    	pcoip_set_auth("hogan", "my_domain", lr_unmask("123abc345def678ghi"));

    	pcoip_connect("my_server", "123.123.123.123", "my_server", "4172" );

    	pcoip_set_display(800, 582);

    	lr_think_time(5); pcoip_mouse_click(626, 13, LEFT_BUTTON, 0, "snapshot2");

    	pcoip_disconnect();

Tips to improve your search results... VuGen Function Reference Version 26.1 Function Reference 26.1 All View Local Help Center View Online Help Center Version: