C16_SetOptions

C16_SetOptions(const vPHANDLE aInstHdl, const vLONG aOptions) : vERROR

Optionen der Datenbankinstanz setzen

Details

• aInstHdl: Instanz-Handle
• aOptions:
  • Optionen:
  • _DbaConnectOpDefault
  • _DbaConnectOpErrorCode
• Resultat: vERROR Fehlerwert
• Siehe: Befehle der Programmierschnittstelle , C16_InitInstance()

Mit dieser Funktion kann bei einer Unterbrechung der Verbindung zum CONZEPT 16 Server der Fehlerdialog unterdrückt werden (_DbaConnectOpErrorCode).

Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle übergeben. Bei einem ungültigen Handle wird der Fehlercode C16ERR_INSTANCE_HDL_INVALID zurück gegeben.

Die in (aOptions) angegebenen Optionen beziehen sich jeweils auf die in (aInstHdl) übergebene Instanz.

Für die Optionen können folgende Werte übergeben werden:

• _DbaConnectOpDefault: 0x00 Optionen zurücksetzen
• _DbaConnectOpErrorCode: 0x04 Fehlercode statt Dialog

Standardmäßig wird bei einem Verbindungsabbruch zum CONZEPT 16 Server bei der nächsten Datenbankoperation ein Dialog "Kommunikation Verbindung abgebrochen" angezeigt. Wird die oben angegebene Option gesetzt, erfolgt keine Fehlermeldung. Statt dessen wird von der Anweisung ein entsprechender Fehlercode zurückgegeben.

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

Beispiel:

InstHandle = C16_initInstance(...);
Result = C16_SetOption(InstHandle,_DbaConnectOpErrorCode);
...
Result = C16_AreaOpen(InstHandle,...);
...