iscServiceOpenEx()

用途

iscServiceOpenEx() 打开基于属性数组的新服务句柄。

语法

isy_INT32 iscServiceOpenEx(
    isy_CONST isy_TCHAR* URL,
    ISCPROPERTY*          property,
    isy_INT32            propertyNum,
    HISCSERV*            phServ);

函数自变量

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

表 122. iscServiceOpenEx() 自变量

数据类型	自变量	使用	描述
isy_CONST isy_TCHAR	`URL`	输入	URL 字符串形式的服务器信息
ISCPROPERTY	property	输入	ISCPROPERTY 类型的一组属性： typedef struct { isy_TCHAR key; //property ID string isy_TCHAR value; //property value string } ISCPROPERTY; 有三个属性可用： `isync.user` － Sync Client 用户名 `isync.password` － Sync Client 密码 `isync.encoding` －目标数据的字符编码用户名和密码属性是必需的。
isy_INT32	propertyNum	输入	属性的数目。
HISCSERV	phServ	输出	服务的句柄。

用法

将 iscServiceOpenEx() 与表示为属性数组的设置配合使用以向服务器请求特定服务的新句柄。该服务器由“统一资源定位器”（URL）字符串标识，该字符串可能包含协议、主机名（或 IP）和端口号。如果将 Sync Server 配置为使用“安全套接字层”（SSL），URL 的协议部分应为“https://”，否则为“http://”。端口号可省略，而 SSL 和非 SSL 的缺省端口分别为端口 443 和端口 80。所有设置（包括用户名和密码）都是在属性数组中指定的。成功后，将通过 phServ 返回服务句柄（HISCSERV）；否则 phServ 为 NULL 且返回错误代码。完成后将使用 iscServiceClose() 关闭服务句柄。

示例：

         int rc = 0;
    HISCSERV hSyncServ;
    ISCPROPERTY properties[3] = {{"isync.user", "myUserName"},
                    {"isync.password", "myPassword"},
                    {"isync.encoding", "ISO8859_1"}}
    rc = iscServiceOpenEx("http://localhost.mycom.com:80", properties, 3, &hSyncServ);

返回码

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

限制

无。

相关参考

iscConfigClose()