sepdcrec

La funzione sepdcrec ottiene le 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
Dimensioni del buffer fornito.

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

Valore restituito

NO_ERROR (0)
OK.

NOCSSRVR (1)
Non sono disponibili file server configurazione.

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)
Buffer fornito troppo piccolo.

NONOS (5)
Il sistema operativo di rete non è stato avviato.

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

LETTORE (7)
Impossibile leggere dal file di configurazione.

NONAP (8)
Il programma di accesso alla rete (NAP) non è stato avviato.

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

ERROR_SERVER (14)
Errore sul server finale della chiamata di procedura remota (RPC).

ERROR_LOCAL_FAILURE (15)
Errore all'estremità locale della RPC.

Commenti

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 precedenti, è ancora supportata una chiamata a sepdcrec prima di sbpuinit , ma questo ordine non è consigliato.

In caso di esito positivo, il buffer contiene puntatori al record utente 3270 appropriato e al record di diagnostica, seguiti dai record stessi. Il token è formattato come illustrato di seguito:

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 su come l'applicazione usa le informazioni sul file di configurazione, vedere Informazioni sulla 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 (un errore interno), l'applicazione deve terminare e non consentire all'utente di usare l'emulazione 3270. I Host Integration Server del log degli errori COM0438 e COM0437 possono essere utilizzati 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.