iscServiceOpen()

Finalidad

iscServiceOpen() abre un nuevo descriptor de contexto de servicio.

Sintaxis

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

Argumentos de la función

La Tabla 120 lista los argumentos válidos utilizados con la función iscServiceOpen().

Tabla 120. Argumentos de iscServiceOpen()

Tipo de datos	Argumento	Uso	Descripción
isy_CONST isy_TCHAR*	`host`	entrada	Nombre de host o el IP
isy_CONST isy_TCHAR*	port	entrada	Número de puerto
isy_CONST isy_TCHAR*	username	entrada	Nombre de usuario para el servicio solicitado
isy_CONST isy_TCHAR*	password	entrada	Contraseña para el servicio solicitado
isy_CONST isy_TCHAR*	reserved	entrada	(Reservado)
HISCSERV*	phServ	salida	Descriptor de contexto para un servicio

Uso

iscServiceOpen() se utiliza para solicitar un nuevo descriptor de contexto para un servicio específico identificado por el nombre de host y el número de puerto. El nombre de usuario y la contraseña se especifican al solicitar un servicio. Si resulta satisfactoria, se devuelve un descriptor de contexto de servicio (HISCSERV) a través de *phServ. De lo contrario, *phServ es NULL y se devuelve el código de retorno.

Códigos de retorno

ISCRTN_Succeeded : Bien
ISCRTN_OutOfMemory : Falta memoria
ISCRTN_ResourceBusy : Recurso bloqueado (por ejemplo, por otra aplicación)
ISCRTN_NotPermitted : Recurso no accesible (por ejemplo, no legible)
ISCRTN_NotFound : Recurso no encontrado (por ejemplo, vía de acceso no encontrada)
ISCRTN_Failed : Otros casos

Restricciones

Ninguna.

Conceptos relacionados

La aplicación Sync Client C/C++ de ejemplo

Tareas relacionadas

Desarrollo de aplicaciones DB2 Everyplace Sync Client utilizando C/C++

Consulta relacionada