Freigeben über

Set_Prepare_To_Receive_Type (CPI-C)

  • Artikel

Der Set_Prepare_To_Receive_Type-Aufruf (Funktionsname cmsptr) gibt an, wie die nachfolgenden Prepare_To_Receive-Aufrufe ausgeführt werden. Es überschreibt die standardmäßige Verarbeitung von "Prepare-to-Receive", die von Initialize_Conversation oder Accept_Conversation eingerichtet wurde. Standardmäßig basiert die Verarbeitung der Vorbereitung auf den Empfang auf der Synchronisierungsebene der Unterhaltung.

Der Typ prepare-to-receive wirkt sich auf alle nachfolgenden Prepare_To_Receive-Aufrufe aus. Sie kann durch erneutes Set_Prepare_To_Receive_Type geändert werden.

Syntax

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

prepare_to_receive_type
Angegebener Parameter. Gibt an, wie nachfolgende Prepare_To_Receive-Aufrufe ausgeführt werden. Mögliche Werte:

CM_PREP_TO_RECEIVE_CONFIRM
Wird verwendet, um dem Partnerprogramm den Inhalt des Sendepuffers der logischen Einheit (LU) und eine Bestätigungsanforderung zu senden. Nach Erhalt der Bestätigung wechselt die Unterhaltung in den Empfangszustand.

CM_PREP_TO_RECEIVE_FLUSH
Wird verwendet, um dem Partnerprogramm den Inhalt der lokalen LUs Sendepuffer zu senden, und ändert die Unterhaltung in den EMPFANGSzustand.

CM_PREP_TO_RECEIVE_SYNC_LEVEL
Wird von der Synchronisierungsebene für Unterhaltungen verwendet, um die Verarbeitung der Empfangsvorbereitung zu bestimmen. Eine Standardsynchronisierungsebene wird von Initialize_Conversation festgelegt und kann von Set_Sync_Level überschrieben werden.

Wenn die Synchronisierungsebene der Unterhaltung CM_NONE ist, wird standardmäßig der Inhalt des lokalen LUs-Sendepuffers an das Partnerprogramm gesendet, und die Unterhaltung wechselt in den RECEIVE-Zustand. Wenn die Synchronisierungsebene der Unterhaltung CM_CONFIRM ist, werden der Inhalt der lokalen LUs sendepuffer und eine Bestätigungsanforderung an das Partnerprogramm gesendet. Die Unterhaltung ändert sich in den Empfangszustand, wenn das Partnerprogramm bestätigt auf die Bestätigungsanforderung antwortet.

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; eine der folgenden Ereignisse:

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

  • Der parameter prepare_to_receive_type ist auf CM_PREP_TO_RECEIVE_CONFIRM festgelegt, die Synchronisierungsebene für Unterhaltungen ist jedoch auf CM_NONE festgelegt.

    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.