Программирование в сетях Windows

538 Приложение А Перечень команд NetBtOB

Команда NCBCHAINSEND Х1ЮКЖ бднвмоЖ

Команда отправляет содержимое двух буферов указанному получателю. Максимальное количество данных, которое можно отправить, — 128 кб (по 64 кб в каждом буфере). Укажите первый буфер и его длину в полях neb buffer и ncbjength соответственно. Используйте байты 0-1 из ncbcallname, чтобы задать длину второго буфера, а байты 2-5 — чтобы сослаться на него.

КомандаNCBCHAINSENDNA

Команда отправляет содержимое двух буферов указанному получателю, не ожидая подтверждения. Максимальное количество данных, которое можно отправить, — 128 кб (по 64 кб в каждом буфере). Укажите первый буфер и его длину в полях nebjbuffer и ncbjength соответственно. Используйте байты 0-1 из ncbjoallname, чтобы задать длину второго буфера, а байты 2-5 — чтобы сослаться на него.

КомандаNCBDELNAME

Команда удаляет имя из локальной таблицы имен. Если удаляемое имя связано с активными сеансами, возвращается ошибка NRC^ACTSES (OxOF). Если ожидают выполнения какие-либо неактивные сеансы — ошибка NRC_NAMERR (0x17).

КомандаNCBDGRECV

Команда получает дейтаграмму, адресованную локальному имени, связанному со значением nebjium. Если ncbjium — OxFF, то команда получает дейтаграммы, адресованные любому локальному имени. Локальное имя может быть именем группы, либо уникальным. Если при отправке дейтаграммы нет команд, ожидающих приема дейтаграмм, данные удаляются. Если предоставленный буфер слишком мал, появится сообщение о невозможности завершения (NRCJNCOMP — 0x06) и данные будут усечены до размера буфера.

540 Приложение А Перечень команд NetBIOS

продолжение

КомандаNCBDGRECVBC

Команда получает широковещательную дейтаграмму от любого имени, выдающего команды отправки таких дейтаграмм. Если предоставленный буфер слишком мал, появится сообщение о невозможности завершения (NRCJNСОМР — ОхОб) и данные будут усечены до размера буфера.

КомандаNCBDGSEND

Команда отправляет дейтаграмму по указанному уникальному или групповому имени. Если в адаптере есть отложенная команда приема дейтаграммы для того же самого имени, то адаптер получит свое собственное сообщение. Выполните локальную команду NCBASTAT — в структуре ADAPTERJ5TATUS будет возвращен максимальный размер дейтаграммы для базового транспортного протокола.

КомандаNCBDGSENDBC

Команда отправляет широковещательную дейтаграмму каждому узлу в ло

кальной сети. Только компьютеры с ожидающими выполнения командам! приема дейтаграмм получат сообщение. Если в локальном адаптере ест

отложенная команда приема дейтаграммы, он получит свое собственно» сообщение. Широковещательныедейтаграммы имеют ограничения по раз меру,упомянутыевописанииNCBDGSEND.

КомандаNCBENUM

Команда нумерует LANA. При этом ncbjouffer должен ссылаться на структуру LANA_ENUM. По возвращении поле length структуры LANA_ENUM будет содержать количество номеров LANA на локальном компьютере. Поле lana из LANA_ENUM заполняется номерами LANA.

КомандаNCBFINDNAME

Команда находит местоположение (имя компьютера) в сети. После ее выполнения буфер ncbjouffer заполняется структурой EINDJVAME_HEADER, за которой следуют одна или несколько структур FINDJVAMEJ3UFFER. Команда специфична для Microsoft Windows NT и не поддерживается другими платформами Win32.

544 Приложение А Перечень команд NetBIOS

продолжение

КомандаNCBLISTEN

Команда прослушивает соединения от другого процесса, локального или удаленного. Если первый символ ncb_callname — звездочка ("), соединение устанавливается с любым адаптером сети, выдавшим команду NCBCALL локальному имени. Имя, генерирующееNCBCALL, возвращается в поле neb callname. Если задан таймаут отправки или приема, он применяется во всех запросах в рамках нового сеанса.

КомандаNCBRECV

Команда получает данные от сеанса с указанным именем. Если ожидающие обработки данные способны получить несколько команд, они обрабатываются в таком порядке.

1.Прием(NCBRECV).

2.Прием всехдля указанного имени (NCBRECVANY). 3- Прием всехдлялюбого имени (NCBRECVANY).

Все команды с одинаковым приоритетом обрабатываются в порядке поступления. Если буфер обмена не достаточно вместителен, выдается ошиб-

546 Приложение А Перечень команд NetBIOS

продолжение

КомандаNCBRESET

Команда сбрасывает указанный номер LANA и затрагивает определенные ресурсы среды.

ШЕсли поле ncbjsn не равно 0, все ресурсы, связанные с ncbjanajium, освобождаются.

ШЕсли поле ncbjsn равно 0, все ресурсы, связанные с ncbjanajium, освобождаются и выделяются новые. Байт ncb_callname[O] задает максимальное количество сеансов, байт ncb_callname[2] — максимальное количество имен, а байт ncb_callname[3]требует, чтобы приложение использовало имя компьютера (у которого номер имени 1).

КомандаNCBSEND

Команда отправляет данные указанному участнику сеанса. Максимальный размер передаваемых данных — 65 536 байт (64 кб). Если удаленная сторона выдает команду завершения связи, все отложенные отправки возвращают ошибку, связанную с закрытием сеанса, —NRCJSCLOSED (0x0А). Отложенные команды отправки обрабатываются в порядке поступления.

КомандаNCBSENDNA

Команда отправляет данные указанному сеансу и не ожидает подтверждения от партнера. В остальном ведет себя так же, как NCBSEND.