Netbios-Funktion (nb30.h)
[Netbios wird unter Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems nicht unterstützt]
Die Netbios-Funktion interpretiert und führt den angegebenen Netzwerksteuerungsblock (NCB) aus.
Die Netbios-Funktion wird in erster Linie für Anwendungen bereitgestellt, die für die NetBIOS-Schnittstelle geschrieben wurden und nach Windows portiert werden müssen. Anwendungen, die keine Kompatibilität mit NetBIOS erfordern, sollten andere Schnittstellen verwenden, z. B. Windows Sockets, Mailslots, Named Pipes, RPC oder verteiltes COM, um Aufgaben auszuführen, die denen ähneln, die von NetBIOS unterstützt werden. Diese anderen Schnittstellen sind flexibler und portierbarer.
Syntax
UCHAR Netbios(
PNCB pncb
);
Parameter
pncb
Ein Zeiger auf eine NCB-Struktur , die den Netzwerksteuerungsblock beschreibt.
Rückgabewert
Bei synchronen Anforderungen ist der Rückgabewert der Rückgabecode in der NCB-Struktur . Dieser Wert wird auch im ncb_retcode Member der NCB-Struktur zurückgegeben.
Für asynchrone Anforderungen gibt es die folgenden Möglichkeiten:
- Wenn der asynchrone Befehl bereits abgeschlossen ist, wenn Netbios an seinen Aufrufer zurückkehrt, ist der Rückgabewert der Rückgabecode der NCB-Struktur, so als wäre es eine synchrone NCB-Struktur .
- Wenn der asynchrone Befehl noch aussteht, wenn Netbios an seinen Aufrufer zurückkehrt, ist der Rückgabewert 0.
Wenn die im ncb_length Member der NCB-Struktur angegebene Pufferlänge falsch ist oder wenn der vom ncb_retcode-Member angegebene Puffer vor Schreibvorgängen geschützt ist, wird der Rückgabewert NRC_BUFLEN.
Hinweise
Wenn ein asynchroner Netzwerksteuerungsblock abgeschlossen wird und der ncb_post Member nichtzero ist, wird die in ncb_post angegebene Routine mit einem einzelnen Parameter aufgerufen. Dieser Parameter enthält einen Zeiger auf eine NCB-Struktur , den Netzwerksteuerungsblock.
Die NCB-Struktur enthält ein Handle eines Ereignisses (ncb_event Member ). Das System legt das Ereignis auf den nicht signalierten Zustand fest, wenn ein asynchroner NetBIOS-Befehl akzeptiert wird, und legt das Ereignis auf den signalierten Zustand fest, wenn der asynchrone NetBIOS-Befehl abgeschlossen ist. Für die Synchronisierung sollten nur manuelle Zurücksetzungsereignisse verwendet werden. Ein angegebenes Ereignis sollte nicht mehr als einem aktiven asynchronen NetBIOS-Befehl zugeordnet sein.
Die Verwendung von ncb_event zum Übermitteln asynchroner Anforderungen erfordert weniger Systemressourcen als die Verwendung ncb_post. Wenn ncb_event nicht zero ist, wird die ausstehende Anforderung abgebrochen, wenn der Thread beendet wird, bevor die Anforderung verarbeitet wird. Dies gilt nicht für Anforderungen, die mit ncb_post gesendet werden.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | nb30.h |
Bibliothek | Netapi32.lib |
DLL | Netapi32.dll |