Funzione Netbios (nb30.h)

[Netbios non è supportato in Windows Vista, Windows Server 2008 e versioni successive del sistema operativo]

La funzione Netbios interpreta ed esegue il blocco di controllo di rete (NCB) specificato.

La funzione Netbios viene fornita principalmente per le applicazioni scritte per l'interfaccia NetBIOS e devono essere convertite in Windows. Le applicazioni che non richiedono la compatibilità con NetBIOS devono usare altre interfacce, ad esempio Windows Sockets, mailslots, named pipe, RPC o COM distribuito per eseguire attività simili a quelle supportate da NetBIOS. Queste altre interfacce sono più flessibili e portabili.

Sintassi

UCHAR Netbios(
  PNCB pncb
);

Parametri

pncb

Puntatore a una struttura NCB che descrive il blocco di controllo di rete.

Valore restituito

Per le richieste sincrone, il valore restituito è il codice restituito nella struttura NCB . Tale valore viene restituito anche nel membro ncb_retcode della struttura NCB .

Per le richieste asincrone, sono disponibili le possibilità seguenti:

• Se il comando asincrono è già stato completato quando Netbios torna al chiamante, il valore restituito è il codice restituito della struttura NCB, come se fosse una struttura NCB sincrona.
• Se il comando asincrono è ancora in sospeso quando Netbios torna al chiamante, il valore restituito è zero.

Se l'indirizzo specificato dal parametro pncb non è valido, il valore restituito è NRC_BADNCB.

Se la lunghezza del buffer specificata nel membro ncb_length della struttura NCB non è corretta o se il buffer specificato dal membro ncb_retcode è protetto dalle operazioni di scrittura, il valore restituito viene NRC_BUFLEN.

Commenti

Al termine di un blocco di controllo di rete asincrono e il membro ncb_post è diverso da zero, la routine specificata in ncb_post viene chiamata con un singolo parametro. Questo parametro contiene un puntatore a una struttura NCB , il blocco di controllo di rete.

La struttura NCB contiene un handle di un evento (il membro ncb_event ). Il sistema imposta l'evento sullo stato non assegnato quando viene accettato un comando NetBIOS asincrono e imposta l'evento sullo stato segnalato al termine del comando NetBIOS asincrono. Per la sincronizzazione devono essere usati solo gli eventi di reimpostazione manuale. Un evento specificato non deve essere associato a più di un comando NetBIOS asincrono attivo.

L'uso di ncb_event per inviare richieste asincrone richiede meno risorse di sistema rispetto all'uso di ncb_post. Inoltre, quando ncb_event è diverso da zero, la richiesta in sospeso viene annullata se il thread termina prima dell'elaborazione della richiesta. Ciò non vale per le richieste inviate tramite ncb_post.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	nb30.h
Libreria	Netapi32.lib
DLL	Netapi32.dll

Vedi anche

BCN