iscServiceOpenEx()

Finalidad

iscServiceOpenEx() abre un nuevo descriptor de contexto de servicio basado en una matriz de propiedad.

Sintaxis 

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

Argumentos de la función

La Tabla 122 lista el argumento válido utilizado con la función iscServiceOpenEx().

Tabla 122. Argumento de iscServiceOpenEx()

Tipo de datos Argumento Uso Descripción
isy_CONST isy_TCHAR URL entrada Información de servidor como serie de URL
ISCPROPERTY property entrada

Matriz de propiedades del tipo ISCPROPERTY: 

typedef struct {
      isy_TCHAR *key;    //serie de ID de propiedad
      isy_TCHAR *value; //serie de valor de propiedad
} ISCPROPERTY;

Hay tres propiedades disponibles:

  • isync.user -- Nombre de usuario de Cliente de sincronización
  • isync.password -- Contraseña de Cliente de sincronización
  • isync.encoding -- Codificación de caracteres de los datos de destino

El nombre de usuario y las propiedades de contraseña son obligatorias.

isy_INT32 propertyNum entrada Número de propiedades.
HISCSERV phServ salida Descriptor de contexto para un servicio.

Uso

iscServiceOpenEx() se utiliza para solicitar un nuevo descriptor de contexto para un servicio específico desde un servidor con valores representados como matriz de propiedad. El servidor se identifica por medio de una serie de Uniform Resource Locator (URL), la cual es posible que contenga el protocolo, el nombre de sistema principal (o IP) y el número de puerto. Si el Servidor de sincronización está configurado para el Secure Socket Layer (SSL), la parte de protocolo del URL debe ser "https://", en caso contrario, será "http://". El número de puerto puede omitirse y los puertos por omisión para SSL y no SSL son el puerto 443 y el puerto 80, respectivamente. Todos los valores (incluyendo el nombre de usuario y la contraseña) se especifican en la matriz de propiedad. Si resulta satisfactoria, se devuelve un descriptor de contexto de servicio (HISCSERV) a través de phServ; en caso contrario, phServ es NULL y se devuelve el código de error. Al finalizar, el descriptor de contexto de servicio se cierra con iscServiceClose().

Ejemplo: 

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

Códigos de retorno

Restricciones

Ninguna.

Consulta relacionada