Flush (CPI-C)

Der Flush-Aufruf (Funktionsname cmflus) sendet den Inhalt des Sendepuffers der lokalen logischen Einheit (LU) an die Partner-LU (und das Programm). Wenn der Sendepuffer leer ist, wird keine Aktion ausgeführt.

Syntax

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

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_OPERATION_NOT_ACCEPTED
Primärer Rückgabecode; Ein vorheriger Vorgang für diese Unterhaltung ist unvollständig.

CM_OPERATION_INCOMPLETE
Primärer Rückgabecode; der Vorgang wurde nicht abgeschlossen (der Verarbeitungsmodus ist nur nicht blockiert) und wird noch ausgeführt. Das Programm kann Wait_For_Conversation ausgeben, um auf den Abschluss des Vorgangs zu warten, oder Cancel_Conversation , um den Vorgang und die Unterhaltung abzubrechen. Wenn Specify_Windows_Handle aufgerufen wurde, sollte die Anwendung auf die Benachrichtigung durch eine Microsoft® Windows-Nachricht® warten und nicht Wait_For_Conversation aufrufen.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; Der durch conversation_ID angegebene Wert ist ungültig.

CM_PROGRAM_STATE_CHECK
Primärer Rückgabecode; die Unterhaltung war nicht im STATUS "SENDEN" oder "SEND_PENDING", als das Programm diesen Anruf ausgestellt hat.

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 Status "SENDEN" oder "SEND_PENDING" befinden.

Wenn der Anruf erfolgreich abgeschlossen wurde (return_code ist CM_OK), befindet sich die Unterhaltung im SEND-Zustand.

Andere Rückgabecodes führen zu keiner Zustandsänderung.

Bemerkungen

Die von Send_Data verarbeiteten Daten werden im lokalen LUs-Sendepuffer gesammelt, bis eine der folgenden Aktionen erfolgt:

• Das lokale Programm gibt den Flush-Aufruf oder einen anderen Aufruf aus, der den LUs-Sendepuffer geleert. (Einige Sendetypen, die durch Set_Send_Type festgelegt werden, umfassen die Funktion zum Leeren.)

• Der Puffer ist voll.

  Die vonSend_Error generierte Zuordnungsanforderung und Fehlerinformationen werden ebenfalls gepuffert.