Freigeben über

Set_Receive_Type (CPI-C)

  • Artikel

Der Set_Receive_Type-Aufruf (Funktionsname cmsrt) gibt an, wie das Programm Daten zu nachfolgenden Empfangsaufrufen empfängt. Er überschreibt den Standard-Empfangstyp, der vom Initialize_Conversation - oder Accept_Conversation-Aufruf eingerichtet wurde. Standardmäßig wartet das Programm, bis Daten eintreffen, wenn sie nicht verfügbar sind, wenn der Empfangsanruf ausgegeben wird.

Der Wert des Empfangstyps wirkt sich auf alle nachfolgenden Receive-Aufrufe aus. Sie kann geändert werden, indem Sie Set_Receive_Type neu ausbringen.

Syntax

  
CM_ENTRY Set_Receive_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *receive_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 oder Accept_Conversation zurückgegeben.

receive_type
Angegebener Parameter. Gibt an, wie Daten vom Programm bei den nachfolgenden Empfangsaufrufen empfangen werden sollen. Mögliche Werte:

CM_RECEIVE_AND_WAIT
Das lokale Programm empfängt alle derzeit verfügbaren Daten aus dem Partnerprogramm. Wenn keine Daten verfügbar sind, wartet das lokale Programm, bis Die Daten eintreffen.

CM_RECEIVE_IMMEDIATE
Das lokale Programm empfängt alle derzeit verfügbaren Daten aus dem Partnerprogramm. Wenn keine Daten verfügbar sind, wartet das lokale Programm nicht.

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 oder receive_type angegebene Wert ist ungültig, oder die Adresse einer Variablen 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.