Condividi tramite

Set_Sync_Level (CPI-C)

  • Articolo

La chiamata Set_Sync_Level (nome funzione cmssl) viene eseguita dal programma di chiamata per specificare il livello di sincronizzazione della conversazione. Il livello di sincronizzazione determina se i programmi sincronizzano l'elaborazione tramite le chiamate Conferma e Conferma.

Questa chiamata esegue l'override del livello di sincronizzazione stabilito dalla chiamata Initialize_Conversation . Il livello di sincronizzazione predefinito è CM_NONE, che indica che non è stata eseguita alcuna sincronizzazione. Questa chiamata non può essere eseguita dopo l'emissione della chiamata Allocate .

Sintassi

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

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation.

sync_level
Parametro fornito. Specifica il livello di sincronizzazione della conversazione. I valori possibili sono:

CM_NONE
I programmi non eseguiranno l'elaborazione della conferma.

CM_CONFIRM
I programmi possono eseguire l'elaborazione della conferma.

return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_STATE_CHECK
Codice restituito primario; la conversazione non è in stato INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; si è verificato uno dei seguenti:

  • Il valore specificato da conversation_ID o sync_level non è valido.

  • Il parametro sync_level specifica CM_NONE ma si è verificato uno dei seguenti elementi: il parametro send_type è impostato su CM_SEND_AND_CONFIRM, il parametro prepare_to_receive_type è impostato su CM_PREP_TO_RECEIVE_CONFIRM oppure il deallocate_type è impostato su CM_DEALLOCATE_CONFIRM.

    CM_PRODUCT_SPECIFIC_ERROR
    Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La conversazione deve essere in stato INITIALIZE.

Non esiste alcuna modifica dello stato.