iscServiceOpen()

用途

iscServiceOpen() 打开新的服务句柄。

语法

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

函数自变量

表 120 列示用于 iscServiceOpen() 函数的有效自变量。

表 120. iscServiceOpen() 自变量

数据类型	自变量	使用	描述
isy_CONST isy_TCHAR*	`host`	输入	主机名或 IP
isy_CONST isy_TCHAR*	port	输入	端口号
isy_CONST isy_TCHAR*	username	输入	所请求服务的用户名
isy_CONST isy_TCHAR*	password	输入	所请求服务的密码
isy_CONST isy_TCHAR*	reserved	输入	（已保留）
HISCSERV*	phServ	输出	服务的句柄

用法

iscServiceOpen() 用于请求由主机名或端口号标识的特定服务的新句柄。当请求服务时指定用户名和密码。成功后，服务句柄（HISCSERV）通过 *phServ 返回。否则，*phServ 为 NULL，返回错误代码。

返回码

ISCRTN_Succeeded：正常
ISCRTN_OutOfMemory：内存不足
ISCRTN_ResourceBusy：资源被锁定（例如，被另一个应用程序）
ISCRTN_NotPermitted：资源不可访问（例如，不可读）
ISCRTN_NotFound：未找到资源（例如，未找到路径）
ISCRTN_Failed：其它情况

限制

无。

相关概念

样本 Sync Client C/C++ 应用程序

相关任务

使用 C/C++ 开发 DB2 Everyplace Sync Client 应用程序

相关参考