iscServiceOpen()

Purpose

iscServiceOpen() opens a new service handle.

Syntax

isy_INT32 iscServiceOpen(
    isy_CONST isy_TCHAR* host,
    isy_CONST isy_TCHAR* port,
    isy_CONST isy_TCHAR* username,
    isy_CONST isy_TCHAR* password,
    isy_CONST isy_VOID*  reserved,
    HISCSERV*            phServ);

Function arguments

Table 120 lists the valid arguments used with the iscServiceOpen() function.

Table 120. iscServiceOpen() arguments

Data type	Argument	Use	Description
isy_CONST isy_TCHAR*	`host`	input	Host name or the IP
isy_CONST isy_TCHAR*	port	input	Port number
isy_CONST isy_TCHAR*	username	input	User name for the requested service
isy_CONST isy_TCHAR*	password	input	Password for the requested service
isy_CONST isy_TCHAR*	reserved	input	(Reserved)
HISCSERV*	phServ	output	Handle to a service

Usage

iscServiceOpen() is used to request a new handle for a specific service that is identified by the host name and port number. The user name and password are specified when requesting a service. Upon success, a service handle (HISCSERV) returns through *phServ. Otherwise, *phServ is NULL, and the error code returns.

Return codes

ISCRTN_Succeeded : OK
ISCRTN_OutOfMemory : Out of memory
ISCRTN_ResourceBusy : Resource locked (for example, by another application)
ISCRTN_NotPermitted : Resource not accessible (for example, not readable)
ISCRTN_NotFound : Resource not found (for example, path not found)
ISCRTN_Failed : Otherwise

Restrictions

None.

Related concepts

The sample Sync Client C/C++ application

Related tasks

Developing DB2 Everyplace Sync Client applications using C/C++

Related reference