sbpuinit

La funzione sbpuinit inizializza 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 parte di 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 di 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ò usarlo per la visualizzazione o la registrazione.

Valore restituito

NO_ERROR
Inizializzazione riuscita.

Qualsiasi altro valore restituito indica che l'inizializzazione non è riuscita. Si tratta in genere di 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 del servizio è piena.

DMMPIPF (567)
Impossibile creare una named pipe.

DMCOMNM (582)
Nessun nome registrato per l'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)
Programma di accesso alla rete (NAP) non avviato.

DMMAXAPP (953)
Solo Windows: è stato superato il numero massimo di applicazioni simultanee.

Osservazioni:

Il punto di ingresso sbpuinit deve sempre essere chiamato prima di qualsiasi altro punto di ingresso DL-BASE o DMOD, 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.