Zum Hauptinhalt springen

C16_QueryPgifInfo

C16_QueryPgifInfo(const vPHANDLE aPgifHdl, vC16_PgifInfo* aInfoBlock) : vERROR​

Informationen über die Programmierschnittstelle ermitteln

Details

Der Befehl füllt eine Struktur vom Typ vC16_PgifInfo mit Informationen zur installierten CONZEPT 16-Programmierschnittstelle. Die Struktur ist folgendermaßen definiert:

typedef struct
{
  vINT  InfoSize;
  vINT  PgifType;
  vCHAR PgifLicense[20];
  vCHAR PgifRelease[8];
  vINT  PgifUserLimit;
  vINT  PgifMemory;
  vINT  PgifMemoryPeak;
}
vC16_PgifInfo;
  • Komponente: Beschreibung
  • InfoSize: Größe der Struktur
  • PgifType: Typ des Moduls 0x0001 _PgifType_Client Non-Client-Server 0x0080 _PgifType_Protocol_16 Windows Client/Server (16-Bit Protokoll) 0x0100 _PgifType_Win32 Windows Client/Server (32-Bit Protokoll) 0x0200 _PgifType_OS2 OS/2 32-Bit
  • PgifLicense[20]: Lizenznummer
  • PgifRelease[8]: Release-Nummer
  • PgifUserLimit: Anzahl zugelassener Benutzer
  • PgifMemory: Aktuell belegter Speicher in Byte
  • PgifMemoryPeak: Maximal belegter Speicher seit der Modulinitialisierung in Byte

Im Parameter (aPgifHdl) wird der Modul-Handle übergeben, der von C16_InitPgif() bereitgestellt wurde. Die Informationen werden in die Informationsstruktur übertragen, deren Adresse in (aInfoBlock) übergeben wurde. Vor dem Aufruf der Funktion muss die Strukturkomponente InfoSize mit der Größe der Struktur initialisiert werden (sizeof(vC16_PgifInfo)).

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