Zum Hauptinhalt springen

C16_QueryServerInfo

C16_QueryServerInfo(const vPHANDLE aInstHdl, vC16_ServerInfo* aInfoBlock) : vERROR​

Informationen über den Server ermitteln

Details

Der Befehl füllt eine Struktur vom Typ vC16_ServerInfo mit Informationen zum Server. Die Struktur ist folgendermaßen definiert:

typedef struct
{
  vINT  InfoSize;
  vCHAR ServerName[64];
  vCHAR ServerType[48];
  vCHAR ServerLicense[20];
  vCHAR ServerRelease[8];
  vINT  ServerProtocol;
  vINT  ServerUserLimit;
}
vC16_ServerInfo;
  • Komponente: Beschreibung
  • InfoSize: Größe der Struktur
  • ServerName[64]: Name des Servers
  • ServerType[48]: Betriebssystem des Servers
  • ServerLicense[20]: Lizenznummer
  • ServerRelease[8]: Release-Nummer
  • ServerProtocol: Integerwert, der das Protokoll des Servers angibt: 2 _ProtocolTCP TCP/IP
  • ServerUserLimit: Anzahl zugelassener Benutzer

Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. 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_ServerInfo)).

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