pcoip_set_auth

Sets credentials for connection to the remote desktop.

C Language

int pcoip_set_auth( const char* username, const char* domain, const char* password );

ExampleTeradici PCoIP Protocol Functions

Arguments

NameComments
usernameUser name.
domainNetwork domain.
passwordUser password. See lr_unmask.

General

pcoip_set_auth sets the credentials for connection to the remote desktop. Call pcoip_set_auth before calling pcoip_connect.

The domain can be passed as part of the user name. In that case, pass an empty string for the domain. For example, pcoip_set_auth("europe\hans", "", lr_unmask("5678cdef91ab0cd"));

Return Values

E_OK 
E_ALREADY_CONNECTEDDo not call this function after the connection is established.
E_NOT_CONNECTEDAction cannot be performed. There is no connection to the remote server.
E_OUT_OF_TIMEFunction timed out.
E_ILLEGAL_PARAMETERIllegal parameter found.
E_INTERNALInternal error found.

Parameterization

The username and domain arguments can be parameterized.

Example

This example shows a connect and disconnect.

	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();