Zum Hauptinhalt springen

C16_CloseArea

C16_CloseArea(const vPHANDLE aInstHdl) : vERROR​

Datenbank schließen

Details

Diese Funktion schließt eine mit C16_OpenArea() geöffnete Datenbank.

In dem Parameter aInstHdl wird der von C16_InitInstance() bereitgestellte Instanz-Handle angegeben, der beim Öffnen der Datenbank mit C16_OpenArea angegeben wurde.

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 geöffnete Datenbank 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
  nErg = C16_InitPgif(0x00400000, &hModule);
  // vInstanz initialisieren
  nErg = nErg + C16_InitInstance(hModule, &hInstance);
  // Datenbank öffnen
  nErg = nErg + C16_OpenArea(hInstance, "TCP:10.1.0.2+10.1.0.1", NULL,
            "T40", "USER", "UserPassword",
             NULL, NULL, 32);
  if(nErg <> 0)
  {
    sprintf(pszMsgText
            "Error %d while opening database\n", nRes);
    MsgBox(pszMsgText);
  }
  // Verarbeitung fortsetzen
  C16_CloseArea(hInstance);    // Datenbank schließen
  C16_TermInstance(hInstance); // Instanz beenden
  C16_TermPgif(hModule);       // Modul beenden
}