Поделиться через

Функция Netbios (nb30.h)

  • Статья

[Netbios не поддерживается в Windows Vista, Windows Server 2008 и последующих версиях операционной системы]

Функция Netbios интерпретирует и выполняет указанный блок управления сетью (NCB).

Функция Netbios предоставляется в основном для приложений, которые были написаны для интерфейса NetBIOS и должны быть перенесены в Windows. Приложения, не требующие совместимости с NetBIOS, должны использовать другие интерфейсы, такие как сокеты Windows, почтовые слоги, именованные каналы, RPC или распределенная COM для выполнения задач, аналогичных поддерживаемым NetBIOS. Эти другие интерфейсы являются более гибкими и переносимыми.

Синтаксис

UCHAR Netbios(
  PNCB pncb
);

Параметры

pncb

Указатель на структуру NCB , описывающую блок управления сетью.

Возвращаемое значение

Для синхронных запросов возвращаемым значением является код возврата в структуре NCB . Это значение также возвращается в элементе ncb_retcode структуры NCB .

Для асинхронных запросов возможны следующие возможности.

  • Если асинхронная команда уже завершена, когда Netbios возвращается вызывающему объекту, возвращаемое значение представляет собой код возврата структуры NCB, как если бы это была синхронная структура NCB .
  • Если асинхронная команда по-прежнему находится в состоянии ожидания, когда Netbios возвращается вызывающей объекту, возвращаемое значение равно нулю.
Если адрес, указанный параметром pncb, недопустим, возвращаемое значение будет NRC_BADNCB.

Если длина буфера, указанная в элементе ncb_length структуры NCB , является неверной или буфер, заданный элементом ncb_retcode , защищен от операций записи, возвращаемое значение будет NRC_BUFLEN.

Комментарии

Когда асинхронный блок управления сетью завершается и элемент ncb_post не равен нулю, подпрограмма, указанная в ncb_post , вызывается с одним параметром. Этот параметр содержит указатель на структуру NCB , блок управления сетью.

Структура NCB содержит дескриптор события ( элемент ncb_event ). Система устанавливает для события состояние без знака при принятии асинхронной команды NetBIOS и устанавливает событие в состояние сигнала при завершении асинхронной команды NetBIOS. Для синхронизации следует использовать только события сброса вручную. Указанное событие не должно быть связано с несколькими активными асинхронными командами NetBIOS.

Использование ncb_event для отправки асинхронных запросов требует меньше системных ресурсов, чем использование ncb_post. Кроме того, если ncb_event не равно нулю, ожидающий запрос отменяется, если поток завершается до обработки запроса. Это не относится к запросам, отправленным с помощью ncb_post.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header nb30.h
Библиотека Netapi32.lib
DLL Netapi32.dll

См. также раздел

NCB