На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

Netbios



The Netbios function interprets and executes the specified network control block (NCB).

UCHAR Netbios(

PNCB pncb // address of network control block
);


Parameters

pncb

Pointer to an NCB structure describing the network control block.



Return Values

For synchronous requests, the return value is the return code of the NCB structure. That value is also returned in the ncb_retcode member of the NCB structure.
There are two return value possibilities for accepted asynchronous requests. If the asynchronous command has already completed when Netbios returns to its caller, the return value is the return code of the NCB structure, just as if it were a synchronous NCB structure. If the asynchronous command is still pending when Netbios returns to its caller, the return value is zero.

If the address specified by the pncb parameter is invalid, the return value is NRC_BADNCB.

Remarks

The Netbios function is primarily for applications written for the IBM NetBIOS system that need to be ported to Windows. Applications that do not have this requirement typically use other interfaces, such as mailslots and named pipes, instead of Netbios.
Netbios contains extensions to the standard IBM NetBIOS 3.0 specification to allow POST routines to be called from C and to operate efficiently in the Windows environment.
When an asynchronous network control block finishes and the ncb_post member is nonzero, the routine specified in ncb_post is called with a single parameter of type PNCB. This parameter contains the address of the finishing network control block. (In the standard IBM NetBIOS 3.0, the address of the network control block is supplied in a nonportable interface.)

Another extension to the NCB structure is a handle of an event (the ncb_event member). The event is set to the nonsignaled state by the system when an asynchronous NetBIOS command is accepted, and it is set to the signaled state when the asynchronous NetBIOS command finishes.
Using ncb_event to submit asynchronous requests requires fewer system resources than using ncb_post. Also, when ncb_event is nonzero, the pending request is canceled if the thread terminates before the request is processed. This is not true for requests sent by using ncb_post.

Only manual reset events should be used with Netbios. A specified event should not be associated with more than one active asynchronous NetBIOS command.
In Win32s, this function does not support features that conflict with the non-preemptive, shared-memory design of Windows 3.1. Because the system does not implement events, this function ignores the ncb_event member of the NCB structure. Also, the system maintains one systemwide name table rather the a per-process name table.

See Also

NCB


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

Netbios



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

UCHAR Netbios(

PNCB pncb // АДРЕС сетевого управляющего блока
);


Параметры

pncb

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



Обратные Величины

Для синхронных просьб, обратная величина является обратным кодом структуры NCB. Эта величина также возвращана на ncb_retcode член структуры NCB.
Есть два возвращают возможности величины для допустимых асинхронных просьб. Если асинхронная команда уже завершилась бы когда возврат Netbios своему вызывающему оператору, обратная величина является обратным кодом структуры NCB, подобно тому, как если это было синхронной структурой NCB. Если асинхронная команда все еще рассматривается когда возврат Netbios своему вызывающему оператору, обратная величина нулевая.

Если адрес определенный параметром pncb недействителен, обратная величина - NRC_BADNCB.

Замечания

Функция Netbios - первоначально для приложений записанных для системы IBM NetBIOS, которая должна быть перенесена на Windows. Приложения, что нет иметь это требование обычно использовать другие интерфейсы, как например, mailslots и назвавшее трубы, вместо Netbios.
Netbios Содержит расширения в стандартную спецификацию IBM NetBIOS 3.0, чтобы допускать программы ПОСТА, которые нужно быть названы из C и, чтобы действовать эффективно в среде Windows.
Когда асинхронный сетевой управляющий блок завершается и ncb_post элемент ненулевой, программа определенная в ncb_post названа единственным параметром типа PNCB. Этот параметр содержит адрес завершающего сетевого управляющего блока. (В стандарте IBM NetBIOS 3.0, адрес сетевого управляющего блока поставлен в nonportable interface.)

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

Только руководство восстановившее события должно быть использовано Netbios. Определенное событие не должно связывано более чем с одной активной асинхронной командой NetBIOS.
В Win32s, эта функция не поддерживает характеристики, которые противоречат с не-упреждающей, более коллективной памятью проекта Windows 3.1. Поскольку система не осуществляет события, эта функция игнорирует ncb_event элемент структуры NCB. Также, система поддерживает один общесистемная таблица имени довольно per-таблицу имени процесса.

Смотри Также

NCB


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz