Zum Hauptinhalt springen

C16_TermInstance

C16_TermInstance(vPHANDLE* aInstHdl) : vERROR​

Datenbank-Instanz beenden

Details

Der Befehl beendet eine Datenbank-Instanz. Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der an die Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben.

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

info

Diese Funktion muss vor Programmende für jede aktive Datenbank-Instanz aufgerufen werden.

Beispiel:

void main(void)
{
  char pszMsgText[80];
  vERROR nRes;        // Funktionsergebnis
  vPHANDLE hModule;   // Modul-Handle
  vPHANDLE hInstance; // Instanz-Handle

  // Modul initialisieren und 4MB Speicher reservieren
  nRes = C16_InitPgif(0x00400000, &hModule);
  // Instanz initialisieren
  nRes = nRes + C16_InitInstance(hModule, &hInstance);
  // Datenbank öffnen
  nRes = nRes + C16_OpenArea(hInstance, "TCP:10.1.0.2+10.1.0.1", NULL,
            "T40", "USER", "UserPassword",
             NULL, NULL, 32);
  if(nRes <> 0)
  {
    sprintf(pszMsgText
            "Error %d at opening database\n", nRes);
    MsgBox(pszMsgText);
  }
  // Verarbeitung fortsetzen
  C16_CloseArea(hInstance);    // Datenbank schließen
  C16_TermInstance(hInstance); // Instanz beenden
  C16_TermPgif(hModule);       // Modul beenden
}