Set_Return_Control (CPI-C)

Artikel
10/14/2023

Der Set_Return_Control-Aufruf (Funktionsname cmsrc) wird vom aufrufenden Programm ausgegeben, um anzugeben, wann die lokale logische Einheit (LU), die auf die Sitzungsanforderung aus dem lokalen Programm zuweisen-Aufruf wirkt, die Steuerung an das lokale Programm zurückgeben soll.

Syntax

  
CM_ENTRY Set_Return_Control(   
  unsigned char FAR *conversation_ID,    
    CM_INT32 FAR *return_control,          
  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 zurückgegeben.

return_control
Angegebener Parameter. Gibt an, wann die lokale LU, die auf den Zuordnungsaufruf wirkt, die Steuerung an das lokale Programm zurückgeben soll. Die folgenden Werte sind zulässig:

CM_IMMEDIATE
Die LU weist eine Konflikt-Gewinner-Sitzung zu, wenn sie sofort verfügbar ist, und gibt die Steuerung an das Programm zurück.

CM_WHEN_SESSION_ALLOCATED
Die LU gibt erst dann die Steuerung an das Programm zurück, wenn eine Sitzung zugewiesen wird oder Fehler auftreten. Wenn eine Sitzung nicht verfügbar ist, wartet das Programm auf eine Sitzung. (Wenn das Sitzungslimit 0 ist, gibt die LU sofort das Steuerelement zurück.)

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; die Unterhaltung befindet sich nicht im INITIALIZE-Zustand.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; Der durch conversation_ID oder return_control angegebene Wert 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 muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.

Hinweise

Dieser Aufruf überschreibt das standardmäßige Rückgabesteuerelement, das von Initialize_Conversation eingerichtet wurde. Standardmäßig wird die Steuerung zurückgegeben, wenn die Sitzung zugeordnet wird. Dieser Aufruf kann nicht ausgegeben werden, nachdem der Aufruf "Zuordnung" ausgegeben wurde.

Weitere Informationen zu Sitzungen finden Sie unter Schreiben von CPI-C-Anwendungen.

Wenn die LU keine Sitzung zuordnen kann, wird die Benachrichtigung für den Aufruf "Zuweisen" zurückgegeben.

Freigeben über