sepdgetinfo

Die sepdgetinfo-Funktion gibt eine Struktur zurück, die die Versionsnummer von Host Integration Server, den Pfad der aktuellen Konfigurationsdatei und das Netzwerkbetriebssystem enthält, über das Host Integration Server ausgeführt wird.

Syntax

  
USHORT sepdgetinfo(   
struct cs_info *pCSInfo   
);  

Parameter

pCSInfo
Zeiger auf einen von der Anwendung bereitgestellten Puffer, der eine cs_info Datenstruktur enthält, in der Systeminformationen zurückgegeben werden. Die Anwendung muss das Längenelement in dieser Datenstruktur festlegen (weitere Informationen finden Sie weiter unten in diesem Thema unter Hinweise); die anderen Member sollten auf NULL-Werte oder Leerzeichen festgelegt werden.

Die cs_info-Struktur

Die zurückgegebene cs_info-Struktur und ihre Member sind wie folgt:

struct cs_info {  
    unsigned short length;  
    unsigned char  major_ver;  
    unsigned char  minor_ver;  
    unsigned char  config_share[80];  
    unsigned short nos;  
 } cs_info;  

Member

length
Länge der von der Anwendung bereitgestellten Datenstruktur.

major_ver
Hauptversionsnummer:

1 für Host Integration Server 1.1 (Verbindungsserver 1.1) 2 für Host Integration Server 2.0 (Verbindungsserver 2.0)

minor_ver
Nebenversionsnummer (dezimal):

10 für Verbindungsserver 1.1 (gibt 1.10) 00 für Verbindungsserver 2.0 (gibt 2.00 an)

config_share[80]
Pfad der ausgeführten Konfigurationsdatei: \\server\share\ (NULL beendet).

Nos
Verwendetes Netzwerkbetriebssystem

1: LAN-Manager

Rückgabewert

NO_ERROR (0)
OK.

NOCSSRVR (1)
Kein Konfigurationsdateiserver verfügbar.

BADLNGTH (2)
Der bereitgestellte Puffer war zu klein.

Hinweise

Die Anwendung muss den Längenmember auf die Länge der cs_info-Struktur (86 Byte in der aktuellen Version) festlegen. Jeder andere Wert wird abgelehnt. Dieser Parameter wird verwendet, um die Kompatibilität mit zukünftigen Versionen sicherzustellen. Eine Anwendung, die diese Länge liefert, erhält immer die hier gezeigten Informationen, aber in zukünftigen Versionen kann es möglich sein, größere Werte anzugeben und weitere Informationen zu erhalten.

Bei erfolgreicher Rückgabe enthält die Datenstruktur cs_info die Versionsnummer von Host Integration Server, den Pfad der aktuellen Konfigurationsdatei und das Netzwerkbetriebssystem, auf dem Host Integration Server ausgeführt wird.

Wenn kein Konfigurationsdateiserver verfügbar ist, sind nur die Versionsnummernfelder gültig. Die anderen Felder sollten nicht überprüft werden.