Set_Fill (CPI-C)

Artikel
10/14/2023

Der Set_Fill-Aufruf (Funktionsname cmsf) gibt an, ob Programme Daten in Form logischer Datensätze oder als angegebene Datenlänge empfangen. Dieser Aufruf ist nur in einfachen Unterhaltungen zulässig.

Syntax

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

Füllen
Angegebener Parameter. Gibt das Formular an, in dem Programme Daten empfangen. Hier einige mögliche Programme:

CM_FILL_BUFFER
Das lokale Programm empfängt Daten, bis die vom requested_length-Parameter des Empfangsaufrufs angegebene Anzahl von Bytes erreicht ist oder bis zum Ende der Daten. Daten werden ohne Berücksichtigung des Logischen Datensatzformats empfangen.

CM_FILL_LL
Die Daten werden im Logischen Datensatzformat empfangen. Die empfangenen Daten können ein vollständiger logischer Datensatz, ein Teil eines logischen Datensatzes sein, der dem requested_length Parameter des Empfangsaufrufs oder dem Ende eines logischen Datensatzes entspricht.

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; einer der folgenden Punkte ist aufgetreten:

Der durch conversation_ID oder Füllung angegebene Wert ist ungültig.
Die aktuelle Unterhaltung wird zugeordnet.

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.

Hinweise

Set_Fill überschreibt die Standardfüllung , die von Initialize_Conversation oder Accept_Conversation eingerichtet wurde. Die Standardfüllung ist CM_FILL_LL.

Der Füllwert wirkt sich auf alle nachfolgenden Empfangsaufrufe aus. Sie kann geändert werden, indem Sie den Set_Fill-Aufrufs erneut aussenden.

Freigeben über