Specify_Secondary_Return_Code - Eigenschaften des erweiterten Returncode setzen

Mit dem Aufruf Specify_Secondary_Return_Code (CMSSRC) setzt das Programm die Eigenschaft erweiterte Returncodes (secondary return code) der CPI-C-Aufrufe.

Diese Funktion gehört zu den zusätzlichen Funktionen des Trägersystems UPIC; sie ist nicht Bestandteil der CPI-C-Schnittstelle.

Syntax

CMSSRC (return_type, return_code)

Parameter

--> return_type	Spezifiziert die Eigenschaft erweiterter Returncode der CPI-C-Aufrufe. Folgende Werte können Sie angeben: CM_RETURN_TYPE_PRIMARY: Die entsprechenden UPIC-Aufrufe geben den erweiterten Returncode zurück. CM_RETURN_TYPE_SECONDARY: Der erweiterte Returncode kann nur über den CMESRC-Aufruf ausgelesen werden. Die entsprechenden UPIC-Aufrufe geben keinen erweiterten Returncode zurück.
<-- return_code	Ergebnis des Funktionsaufrufs.

Ergebnis (return_code)

CM_OK

Aufruf OK

CM_NO_SECONDARY_RETURN_CODE

Die Eigenschaft secondary return code (erweiterter Returncode) steht nicht zur Verfügung.

CM_PROGRAM_PARAMETER_CHECK

Der Wert des return_type ist ungültig.

CM_PROGRAM_STATE_CHECK

Das Programm ist im Zustand “Start”.

CM_PRODUCT_SPECIFIC_ERROR

Die UPIC-Instanz konnte nicht gefunden werden.

Hinweis

Die Funktion kann unmittelbar nach einem Enable_UTM_UPIC-Aufruf aufgerufen werden. Sie hat keinerlei Wirkung auf den Enable_UTM_UPIC-Aufruf.

Zustandsänderung

Keine Zustandsänderung.

Verhalten im Fehlerfall

CM_PROGRAM_PARAMETER_CHECK

Programm ändern.

CM_PROGRAM_STATE_CHECK

Programm ändern.

CM_PRODUCT_SPECIFIC_ERROR

Das Betriebssystem kann nicht genügend Speicherplatz für interne Puffer bereitstellen. Überprüfen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf. Ihr System neu.

Funktionsdeklaration: Specify_Secondary_Return_Code

CM_ENTRY Specify_Secondary_Return_Code (
                           CM_INT32        CM_PTR  return_type,
                           CM_RETURN_CODE  CM_PTR  return_code )