Accept_Conversation (CPI-C)

Der Accept_Conversation Aufruf (Funktionsname cmaccp) wird vom aufgerufenen Programm ausgegeben, um die eingehende Unterhaltung zu akzeptieren und bestimmte Unterhaltungsmerkmale festzulegen. Eine Liste der anfänglichen Unterhaltungsmerkmale finden Sie unter "Merkmale der ersten Unterhaltung".

Syntax

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

Die Parameter

conversation_ID
Zurückgegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Sie wird von nachfolgenden CPI-C Aufrufen verwendet und zurückgegeben, wenn der Rückgabecode entweder CM_OK oder CM_OPERATION_INCOMPLETE ist. Wenn der Rückgabecode CM_OPERATION_INCOMPLETE ist, kann der parameter conversation_ID von der Anwendung verwendet werden, um auf die Unterhaltung zu warten oder abzubrechen.

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; Es ist keine eingehende Unterhaltung (nur Blockierungsmodus) vorhanden, oder es wurde kein NAME des lokalen Transaktionsprogramms (TP) eingerichtet.

CM_OPERATION_INCOMPLETE
Primärer Rückgabecode; Ein Nichtblockierungsvorgang wurde für die Unterhaltung gestartet, ist aber nicht abgeschlossen. Das Programm kann Wait_For_Conversation auf den Abschluss des Vorgangs warten oder Cancel_Conversation , um den Vorgang und die Unterhaltung abzubrechen.

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 ZUSTAND ZURÜCKSETZEN befinden, wenn Accept_Conversation ausgegeben wird.

Wenn der Anruf erfolgreich ist, ändert sich die Unterhaltung in den STATUS EMPFANGEN. Wenn der Anruf fehlschlägt, bleibt der Zustand unverändert.

Bemerkungen

Bei erfolgreicher Ausführung dieses Aufrufs generiert CPI-C einen 8-Byte-Unterhaltungsbezeichner. Dieser Bezeichner ist ein erforderlicher Parameter für alle anderen CPI-C Aufrufe, die vom aufgerufenen Programm für diese Unterhaltung ausgegeben wurden.

Eingehende Unterhaltungen werden gemäß dem angegebenen TP-Zielnamen akzeptiert, der mit lokalen TP-Namen übereinstimmen muss, die eingerichtet wurden. Lokale TP-Namen können durch implementierungsabhängige Methoden oder durch das Programm eingerichtet werden, das Specify_Local_TP_Name aufruft. Auf diese Weise kann ein Programm mehrere lokale TP-Namen haben. Das Programm kann Extract_TP_Name aufrufen, um den in der eingehenden Unterhaltung angegebenen Namen zu ermitteln.

Der Vorgang wird im Nichtblockierungsmodus ausgeführt, wenn das Programm zuvor Specify_Local_TP_Name aufgerufen hat; andernfalls wird sie im Blockierungsmodus ausgeführt.