sbpuinit

La funzione sbpuinit inizializza la funzione DL-BASE.

Sintassi

  
USHORT sbpuinit(   
HANDLE *sema4ptr,   
USHORT proctype,   
USHORT servtype,   
UCHAR *uname   
);  

Parametri

sema4ptr
Semaforo creato da Dynamic Access Module (DMOD), cancellato da DMOD quando è disponibile un messaggio. Questo indirizzo è destinato all'uso interno da Host Integration Server. L'applicazione non deve successivamente tentare di fare riferimento all'indirizzo.

proctype
Tipo di processo: CLIENT-2.

servtype
Tipo di servizio/client: CES3270-2.

Uname
Puntatore a un buffer di caratteri di lunghezza almeno 21 caratteri; il nome utente di LAN Manager o un altro nome di identificazione appropriato per il sistema operativo di rete, viene restituito all'applicazione in questo buffer. L'applicazione non deve usare questo parametro, ma può usarla per la visualizzazione o la registrazione.

Valore restituito

NO_ERROR
Inizializzazione completata.

Qualsiasi altro valore restituito indica che l'inizializzazione non è riuscita. Questo è in genere un codice restituito dal sistema operativo. Vengono usati anche i valori seguenti:

DMLTABF (555)
La tabella L è piena.

DMMNWGI (562)
Impossibile ottenere informazioni sul sistema operativo di rete.

DMDSTFL (563)
La tabella di servizio è completa.

DMMPIPF (567)
Impossibile creare una pipe denominata.

DMCOMNM (582)
Nessun nome registrato per questa applicazione.

DMCOMDUP (596)
Un servizio è già in esecuzione con lo stesso nome.

DMNOTLOG (598)
L'utente non è connesso al sistema operativo di rete.

DMCFGOPN (616)
Impossibile aprire il file di configurazione.

DMCFGREAD (618)
Impossibile leggere dal file di configurazione.

DMNONAP (625)
Il programma di accesso alla rete (NAP) non viene avviato.

DMMAXAPP (953)
Solo Windows: numero massimo di applicazioni simultanee superate.

Commenti

Il punto di ingresso sbpuinit deve essere sempre chiamato prima di qualsiasi altro punto di ingresso DL-BASE o DMOD tranne SNAGetVersion. Per i nuovi emulatori, sepdcrec deve essere chiamato dopo sbpuinit. A causa dell'ordine di chiamate usate negli emulatori meno recenti, una chiamata a sepdcrec prima che sbpuinit sia ancora supportata, ma questo ordine non è consigliato.