Freigeben über

Set_Conversation_Type (CPI-C)

Der Set_Conversation_Type Aufruf (Funktionsname cmsct) wird vom aufrufenden Programm ausgegeben, um eine Unterhaltung als zugeordnet oder einfach zu definieren. Durch diesen Aufruf wird der von Initialize_Conversation festgelegte Standardunterhaltungstyp außer Kraft gesetzt. Der Standardunterhaltungstyp ist CM_MAPPED_CONVERSATION. Dieser Aufruf kann nicht ausgegeben werden, nachdem "Zuweisung " ausgegeben wurde.

Syntax

  
CM_ENTRY Set_Conversation_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *conversation_type,    
    CM_INT32 FAR *return_code           
);

Die Parameter

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

conversation_type
Angegebener Parameter. Gibt den Typ der Unterhaltung an, die durch "Zuweisung" zugewiesen werden soll. Mögliche Werte:

  • CM_BASIC_CONVERSATION

  • CM_MAPPED_CONVERSATION

    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; einer der folgenden Ereignisse:

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

  • Der parameter conversation_type gibt eine zugeordnete Unterhaltung an, das Füllmerkmal wird jedoch auf CM_FILL_BUFFER festgelegt, was mit zugeordneten Unterhaltungen nicht kompatibel ist. Bevor Sie den zugeordneten Unterhaltungstyp ändern, müssen Sie den Set_Fill Aufruf ausgeben, um den Fülltyp in CM_FILL_LL zu ändern.

  • Der parameter conversation_type gibt eine zugeordnete Unterhaltung an. Ein vorheriger Set_Log_Data Anruf, der nur in einfachen Unterhaltungen zulässig ist, ist jedoch noch in Kraft.

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

Statusänderungen

Die Unterhaltung muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.

  • Last updated on