Extract_Sync_Level (CPI-C)

Der Extract_Sync_Level-Aufruf (Funktionsname cmesl) gibt die Synchronisierungsebene für eine angegebene Unterhaltung zurück.

Syntax

  
CM_ENTRY Extract_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 oder Accept_Conversation zurückgegeben.

sync_level
Zurückgegebener 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 die 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_PARAMETER_CHECK
Primärer Rückgabecode; Der durch conversation_ID angegebene Wert ist ungültig.

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

Zustandsänderungen

Die Unterhaltung kann sich in einem beliebigen Zustand mit Ausnahme von RESET befinden.

Es gibt keine Zustandsänderung.