Compartir a través de

Set_Sync_Level (CPI-C)

  • Artículo

El programa de invocación emite la llamada Set_Sync_Level (nombre de función cmssl) para especificar el nivel de sincronización de la conversación. El nivel de sincronización determina si los programas sincronizan su procesamiento a través de las llamadas Confirm y Confirmed .

Esta llamada invalida el nivel de sincronización establecido por la llamada Initialize_Conversation . El nivel de sincronización predeterminado es CM_NONE, lo que indica que no hay sincronización. Esta llamada no se puede emitir después de que se haya emitido la llamada de asignación .

Sintaxis

  
CM_ENTRY Set_Sync_Level(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *sync_level,              
  CM_INT32 FAR *return_code              
);

Parámetros

conversation_ID
Parámetro proporcionado. Especifica el identificador de la conversación. El valor de este parámetro lo devolvió Initialize_Conversation.

sync_level
Parámetro proporcionado. Especifica el nivel de sincronización de la conversación. Los valores posibles son:

CM_NONE
Los programas no realizarán el procesamiento de confirmación.

CM_CONFIRM
Los programas pueden realizar el procesamiento de confirmación.

return_code
Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente.

CM_PROGRAM_STATE_CHECK
Código de retorno principal; la conversación no está en estado INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Código de retorno principal; se produjo una de las siguientes acciones:

  • El valor especificado por conversation_ID o sync_level no es válido.

  • El parámetro sync_level especifica CM_NONE pero se ha producido una de las siguientes acciones: el parámetro send_type se establece en CM_SEND_AND_CONFIRM, el parámetro prepare_to_receive_type se establece en CM_PREP_TO_RECEIVE_CONFIRM o el deallocate_type se establece en CM_DEALLOCATE_CONFIRM.

    CM_PRODUCT_SPECIFIC_ERROR
    Código de retorno principal; se produjo un error específico del producto y se ha registrado en el registro de errores de productos.

Cambios de estado

La conversación debe estar en estado INITIALIZE.

No hay ningún cambio de estado.