Zum Hauptinhalt springen

C16_TermPgif

C16_TermPgif(const vPHANDLE aPgifHdl) : vERROR​

Programmierschnittstelle beenden

Details

Der Befehl beendet das Programmierschnittstellen-Modul und gibt den reservierten Speicher frei.

In (aPgifHdl) steht der von C16_InitPgif() bereitgestellte Modul-Handle.

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

info

Diese Funktion muss einmal vor Programmende 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
}