netbios 函数 (nb30.h)
[Windows Vista、Windows Server 2008 和操作系统的后续版本不支持 Netbios ]
Netbios 函数 (NCB) 解释并执行指定的网络控制块。
Netbios 函数主要用于为 NetBIOS 接口编写的、需要移植到 Windows 的应用程序。 不需要与 NetBIOS 兼容的应用程序应使用其他接口（如 Windows 套接字、mailslot、命名管道、RPC 或分布式 COM）来完成与 NetBIOS 支持的任务类似的任务。 这些其他接口更灵活且可移植。
语法
UCHAR Netbios(
PNCB pncb
);
参数
pncb
指向描述网络控制块的 NCB 结构的指针。
返回值
对于同步请求，返回值是 NCB 结构中的返回代码。 该值也会在 NCB 结构的 ncb_retcode 成员中返回。
对于异步请求，有以下可能：
- 如果异步命令在 Netbios 返回给其调用方时已完成，则返回值是 NCB 结构的返回代码，就像它是同步 NCB 结构一样。
- 如果 当 Netbios 返回给其调用方时异步命令仍处于挂起状态，则返回值为零。
如果 NCB 结构的 ncb_length 成员中指定的缓冲区长度不正确，或者ncb_retcode成员指定的缓冲区不受写入操作保护，则返回值NRC_BUFLEN。
注解
当异步网络控制块完成并且 ncb_post 成员为非零时，使用单个参数调用 ncb_post 中指定的例程。 此参数包含指向 NCB 结构（网络控制块）的指针。
NCB 结构包含 (ncb_event成员) 的事件句柄。 当接受异步 NetBIOS 命令时，系统将事件设置为未签名状态，并在异步 NetBIOS 命令完成时将事件设置为信号状态。 仅应将手动重置事件用于同步。 指定的事件不应与多个活动的异步 NetBIOS 命令相关联。
与使用 ncb_post 相比，使用 ncb_event 提交异步请求所需的系统资源更少。 此外，当 ncb_event 为非零时，如果线程在处理请求之前终止，则会取消挂起的请求。 对于使用 ncb_post 发送的请求，情况并非如此。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | nb30.h |
| Library | Netapi32.lib |
| DLL | Netapi32.dll |