Freigeben über

Set_Conversation_Type (CPI-C)

  • Artikel

Der Set_Conversation_Type-Aufruf (Funktionsname cmsct) wird vom aufrufenden Programm ausgegeben, um eine Konversation als zugeordnet oder einfach zu definieren. Dieser Aufruf überschreibt den Standardunterhaltungstyp, der von Initialize_Conversation eingerichtet wurde. Der Standardunterhaltungstyp ist CM_MAPPED_CONVERSATION. Dieser Aufruf kann nicht ausgegeben werden, nachdem "Allocate" ausgestellt wurde.

Syntax

  
CM_ENTRY Set_Conversation_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *conversation_type,    
    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.

conversation_type
Angegebener Parameter. Gibt den Typ der Unterhaltung an, die von Allocate zugeordnet 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; eine der folgenden Ereignisse:

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

  • Der parameter conversation_type gibt eine zugeordnete Unterhaltung an, aber das Füllmerkmal ist auf CM_FILL_BUFFER festgelegt, was mit zugeordneten Unterhaltungen nicht kompatibel ist. Bevor Sie den Konversationstyp in zugeordnet ändern, müssen Sie den Set_Fill Aufruf ausführen, 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 weiterhin gültig.

    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.