sepdgetinfo

La funzione sepdgetinfo restituisce una struttura contenente il numero di versione di Host Integration Server, il percorso del file di configurazione corrente e il sistema operativo di rete su cui è in esecuzione Host Integration Server.

Sintassi

  
USHORT sepdgetinfo(   
struct cs_info *pCSInfo   
);  

Parametri

pCSInfo
Puntatore a un buffer fornito dall'applicazione, contenente una struttura di dati cs_info in cui vengono restituite le informazioni di sistema. L'applicazione deve impostare il membro length in questa struttura di dati (per ulteriori informazioni, vedere Osservazioni più avanti in questo argomento); gli altri membri devono essere impostati su valori Null o spazi vuoti.

Struttura cs_info

La struttura cs_info restituita e i relativi membri sono i seguenti:

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

Membri

length
Lunghezza della struttura dei dati fornita dall'applicazione.

major_ver
Numero di versione principale:

1 per Host Integration Server 1.1 (Server di connessione 1.1) 2 per Host Integration Server 2.0 (Server di connessione 2.0)

minor_ver
Numero di versione secondaria (decimale):

10 per Connection Server 1.1 (indica 1.10)00 per Connection Server 2.0 (indica 2.00)

config_share[80]
Percorso del file: di configurazione in esecuzione \\server\share\ (terminazione Null).

Nos
Sistema operativo di rete in uso

1: Lan Manager

Valore restituito

NO_ERROR (0)
OK.

NOCSSRVR (1)
Nessun file server di configurazione disponibile.

BADLNGTH (2)
Il buffer fornito era troppo piccolo.

Commenti

L'applicazione deve impostare il membro di lunghezza sulla lunghezza della struttura cs_info (86 byte nella versione corrente). Qualsiasi altro valore verrà rifiutato. Questo parametro viene usato per garantire la compatibilità con le versioni future; un'applicazione che fornisce questa lunghezza otterrà sempre le informazioni illustrate qui, ma nelle versioni future potrebbe essere possibile specificare valori più grandi e ottenere ulteriori informazioni.

In caso di esito positivo, la struttura dei dati cs_info contiene il numero di versione di Host Integration Server, il percorso del file di configurazione corrente e il sistema operativo di rete su cui è in esecuzione Host Integration Server.

Se non è disponibile alcun file server di configurazione, sono validi solo i campi del numero di versione; gli altri campi non devono essere controllati.