Zum Hauptinhalt springen

C16_ArgInfo

C16_ArgInfo(const vPHANDLE aInstHdl, const vINT aPosition, vINT* aType, vINT* aOptions, vINT* aLength, vINT* aMaxLength, vINT* aElements) : vERROR​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von Clients mit Programmierschnittstelle Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle

Informationen zu einem Argument ermitteln

Details

  • aInstHdl: Instanz-Handle
  • aPosition: Position des Parameters
  • aType: Typ des Parameters
  • aOptions: Art der Übergabe
  • aLength: Länge des Arguments
  • aMaxLength: Maximale Länge des Arguments
  • aElements: Anzahl Elemente in einem Array
  • Resultat: vERROR Fehlerwert C16ERR_OK kein Fehler C16ERR_INSTANCE_HDL_INVALID Instanz-Handle ungültig C16ERR_NO_ARGUMENT Das Argument ist nicht vorhanden C16ERR_ARGUMENT_UNDEFINED Das Argument ist nicht definiert / instanziiert
  • Siehe: C16_ArgCount() , C16_ArgRead() , C16_ArgWrite()

Mit dieser Funktion können unterschiedliche Informationen zu einem Übergabeparameter ermittelt werden. In (aInstHdl) wird der Instanzen-Handle, in (aPosition) die Position des Argumentes angegeben. Alle weiteren Parameter sind Zeiger auf Variablen, die mit den entsprechenden Informationen gefüllt werden. Wird eine Information nicht benötigt, kann auch ein NULL-Zeiger übergeben werden.

  • aType Hier wird der Typ des übergebenen Arguments zurückgeliefert. Der Wert kann mit folgenden Konstanten verglichen werden:

  • Wert: Konstante C-Typ

  • 1: _TypeAlpha vCHAR

  • 2: _TypeDate vDATE

  • 4: _TypeWord vWORD

  • 5: _TypeDecimal vBYTE[32]

  • 6: _TypeMemo vCHAR

  • 7: _TypeInt vLONGs

  • 8: _TypeBigInt vXLONGs

  • 9: _TypeFloat vFLOAT

  • 10: _TypeLogic vBOOL8

  • 11: _TypeTime vTIME

  • aOptions Ein Parameter kann sowohl als beschreibbar oder nicht-beschreibbar übergeben werden. Wird das Argument als beschreibbar übergeben, steht in dieser Variable der Wert _ArgOptVAR (0x40). Wird eine Zeichenkette als beschreibbar übergeben, müssen die Parameter (aLength) und (aMaxLength) ebenfalls übergeben werden. Wird ein Array übergeben, steht hier der Wert _ArgOptARRAY (0x80). Die Anzahl der Elemente steht in (aElements).

  • aLength und aMaxLength Wird eine Zeichenkette übergeben, steht hier die Länge der Zeichenkette. Die maximale Länge, die diesem Wert zugewiesen werden kann, steht in (aMaxLength). Dieser Wert ist nur von Bedeutung, wenn die Zeichenkette als beschreibbar übergeben wurde.

info

Die Variable für die Zeichenkette muss mindestens ein Zeichen länger sein, damit das Nullzeichen Platz hat.

  • aElements Wurde ein Array übergeben, kann hier die Anzahl der Elemente ermittelt werden.