iscEngineGetPref()

Finalidad

iscEngineGetPref() recupera el valor de preferencia actual.

Sintaxis

isy_INT32 iscEngineGetPref(
    HISCENG              hEngine,
    isy_CONST isy_INT32  prefID,
    isy_TCHAR           *prefVal,
    isy_CONST isy_INT32  prefLen);

Argumentos de la función

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

Tabla 148. Argumentos de iscEngineGetPref()

Tipo de datos Argumento Uso Descripción
HISCENG hEngine entrada Descriptor de contexto para el motor de sincronización
isy_CONST isy_INT32 prefID entrada ID de preferencia, que es uno de los valores siguientes:
  • ISCPREF_Timeout: Duración del tiempo de espera para recibir mensajes
  • ISCPREF_Trace: Rastreo detallado.
isy_TCHAR* prefVal salida Puntero al almacenamiento intermedio para almacenar el valor de preferencia devuelto. Existen algunas constantes de preferencia predefinidas.

Para la preferencia ISCPREF_Trace:

  • ISCCONST_TraceON: Activar el rastreo de depuración detallado
  • ISCCONST_TraceOFF: Desactivar el rastreo de depuración detallado

Para la preferencia ISCPREF_Timeout:

  • ISCCONST_TimeoutNever: Nunca se excede del tiempo de espera mientras se espera la respuesta del servidor.
  • ISCCONST_TimeoutMinimum: Duración mínima del tiempo de espera
isy_CONST isy_INT32 prefLen entrada Tamaño del almacenamiento intermedio proporcionado (prefVal).

Uso

Utilice iscEngineGetPref() para obtener el valor de preferencia (que es un valor por omisión o el valor establecido por iscEngineSetPref()) de un motor de sincronización.

Códigos de retorno

Restricciones

El almacenamiento intermedio proporcionado debe ser suficientemente grande para almacenar los valores de las diversas preferencias:

Conceptos relacionados

Tareas relacionadas

Consulta relacionada