Freigeben über

Set_Sync_Level (CPI-C)

  • Artikel

Der Set_Sync_Level Aufruf (Funktionsname cmssl) wird vom aufrufenden Programm ausgegeben, um die Synchronisierungsebene der Unterhaltung anzugeben. Die Synchronisierungsebene bestimmt, ob die Programme ihre Verarbeitung über die Aufrufe Bestätigen und Bestätigt synchronisieren.

Dieser Aufruf überschreibt die durch den Initialize_Conversation-Aufruf festgelegte Synchronisierungsebene. Die Standardsynchronisierungsebene ist CM_NONE, was angibt, dass keine Synchronisierung erfolgt. Dieser Aufruf kann nicht ausgegeben werden, nachdem der Allocate-Aufruf ausgegeben wurde.

Syntax

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

Parameter

conversation_ID
Angegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Der Wert dieses Parameters wurde von Initialize_Conversation zurückgegeben.

sync_level
Angegebener Parameter. Gibt die Synchronisierungsebene der Unterhaltung an. Mögliche Werte:

CM_NONE
Die Programme führen keine Bestätigungsverarbeitung durch.

CM_CONFIRM
Die Programme können eine Bestätigungsverarbeitung durchführen.

return_code
Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; Der Aufruf wurde erfolgreich ausgeführt.

CM_PROGRAM_STATE_CHECK
Primärer Rückgabecode; Die Unterhaltung befindet sich nicht im INITIALIZE-Zustand.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; eine der folgenden Ereignisse:

  • Der durch conversation_ID oder sync_level angegebene Wert ist ungültig.

  • Der parameter sync_level gibt an, CM_NONE aber einer der folgenden Ereignisse aufgetreten ist: der parameter send_type wird auf CM_SEND_AND_CONFIRM, der prepare_to_receive_type parameter auf CM_PREP_TO_RECEIVE_CONFIRM oder der deallocate_type auf CM_DEALLOCATE_CONFIRM festgelegt.

    CM_PRODUCT_SPECIFIC_ERROR
    Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.