sepdcrec

La funzione sepdcrec ottiene informazioni di configurazione. L'applicazione chiama questa funzione per ottenere le informazioni di configurazione 3270 per il nome con cui l'utente ha eseguito l'accesso al sistema operativo di rete. La chiamata registra anche questo nome utente nella tabella del servizio.

Sintassi

  
USHORT sepdcrec(   
UCHAR *pBuffer,  
USHORT length,  
USHORT *numbytes  
);  

Parametri

pBuffer
Puntatore a un buffer fornito dall'applicazione, in cui vengono restituite le informazioni di configurazione.

length
Dimensione del buffer fornito.

Numbytes
Utilizzato da Host Integration Server per restituire il numero di byte di informazioni restituite nel buffer.

Valore restituito

NO_ERROR (0)
OK.

NOCSSRVR (1)
Nessun file server di configurazione disponibile.

NODGNREC (2)
Nessun record di diagnostica trovato nel file di configurazione.

NOUSRREC (3)
Nessun record utente trovato nel file di configurazione per questo utente.

BUF2SMAL (4)
Il buffer fornito era troppo piccolo.

NONOS (5)
Sistema operativo di rete non avviato.

NOTLOGON (6)
L'utente non è connesso al sistema operativo di rete.

LETTORE (7)
Impossibile leggere dal file di configurazione.

NONAP (8)
Programma di accesso alla rete (NAP) non avviato.

MAXAPP (9)
Solo Windows: è stato superato il numero massimo di applicazioni simultanee.

ERROR_SERVER (14)
Errore alla fine del server della chiamata di procedura remota (RPC).

ERROR_LOCAL_FAILURE (15)
Errore alla fine locale della rpc.

Osservazioni:

La funzione sbpuinit deve sempre essere chiamata prima di qualsiasi altro punto di ingresso DL-BASE o DMOD (Dynamic Access Module), ad eccezione di SNAGetVersion. Per i nuovi emulatori, sepdcrec deve essere chiamato dopo sbpuinit. A causa dell'ordine delle chiamate usate negli emulatori meno recenti, una chiamata a sepdcrec prima che sbpuinit sia ancora supportata, ma questo ordine non è consigliato.

In caso di esito positivo, il buffer contiene puntatori al record utente 3270 appropriato e al record di diagnostica, seguito dai record stessi. Il formato è il seguente:

TECWRKUS *pUserRecord,   
TEDIAGNS *pDiagRecord   
);  

(UserRecord- lunghezza variabile)

(DiagRecord)

È necessario accedere ai due record usando i puntatori forniti.

Per informazioni dettagliate sul formato di questi record e sul modo in cui l'applicazione usa le informazioni sul file di configurazione, vedere Informazioni di configurazione.

Se non è presente alcun record utente 3270 per questo utente nel file di configurazione o se non viene trovato alcun record di diagnostica nel file di configurazione (errore interno), l'applicazione deve terminare e non consentire all'utente di usare l'emulazione 3270. I messaggi del log degli errori di Host Integration Server COM0438 e COM0437 possono essere usati per segnalare questi errori.

Se il buffer fornito è troppo piccolo per le informazioni restituite, il contenuto del buffer non è definito e non deve essere esaminato, ma il parametro numbytes conterrà il numero totale di byte di informazioni disponibili, ovvero le dimensioni dei due puntatori più i due record di configurazione. L'applicazione deve riprovare con un buffer di almeno questa dimensione.