Zum Hauptinhalt springen

C16_ProcArgument

C16_ProcArgument(const vPHANDLE aInstHdl, const vBYTE aArgType, void* aArgVal, const vBOOL aVarArg, const vBYTE aMaxLen): vERROR​

Prozedurargument übergeben

Details

Mit dieser Funktion können vor dem Aufruf einer Prozedur mit C16_ProcCall() Argumente definiert werden. Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. (aArgType) beinhaltet den Typ des Übergabeparameters. Zur Festlegung des Types können folgende Konstanten verwendet werden:

  • aArgType: Parametertyp
  • _TypeAlpha: vCHAR (C++) / vPCHAR (Delphi)
  • _TypeByte: vBYTE
  • _TypeCaltime: vCALTIME
  • _TypeDate: vDATE
  • _TypeFloat: vFLOAT
  • _TypeHandle: vPHANDLE
  • _TypeInt: vINT
  • _TypeLogic: vBOOL
  • _TypePoint: vPOINT
  • _TypeRect: vRECT
  • _TypeTime: vTIME
  • _TypeWord: vWORD

In (aArgVal) wird der Wert des Parameters übergeben. Die Übergabe kann als Wert (aVarArg = false) oder als Referenz (aVarArg = true) erfolgen. (aMaxLength) wird nur benötigt, wenn in (aArgVal) eine Zeichenkette als VAR-Parameter (aVarArg = true) übergeben wird. Der Wert gibt die maximale Anzahl der Zeichen an, die zurückgegeben werden können. In allen anderen Fällen wird der Wert ignoriert.:::info Sollen einer Prozedur mehrere Argumente übergeben werden, muss die Funktion für jedes Argument aufgerufen werden.::::::info Bei der Übergabe als Referenz (aVarArg = true) ist zu beachten, dass das entsprechende Argument der durch C16_ProcCall aufzurufenden CONZEPT 16-Funktion nicht mit var definiert sein darf.:::

Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte ).

Beispiel:

Deklaration der CONZEPT 16-Funktion:

sub C16_Proc
(
  aText  : alpha;
  aValue : int;
)
: logic;

DLL-Schnittstelle (C-Code):

vCHAR  tParameter[11] = "Text";
vINT   tParameter = 5;
vBYTE  tType;
vBOOL* tResult;

// Argument vom Typ alpha mit Referenzübergabe.
err = C16_ProcArgument(instHdl,_TypeAlpha,tParameter,true,10);

// Argument vom Typ integer ohne Referenzübergabe.
err = C16_ProcArgument(instHdl,_TypeInt,&tParameter,false,0);

// Aufrufen der Funktion und Resultat auswerten.
err = C16_ProcCall(instHdl,"C16_Proc");
err = C16_ProcResult(instHdl,&tType,(void**)&tResult);

// Result = true?
if (*tResult > 0)
  ...