netbios 函式 (nb30.h)
[Windows Vista、Windows Server 2008 和後續版本的操作系統不支援 Netbios ]
Netbios 函式會解譯並執行指定的網路控制區塊, (NCB) 。
Netbios 函式主要是針對針對 NetBIOS 介面所撰寫的應用程式提供,而且必須移植到 Windows。 不需要與 NetBIOS 相容的應用程式應該使用其他介面,例如 Windows Sockets、mailslots、命名管道、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_event 提交異步要求需要比使用 ncb_post少的系統資源。 此外,當 ncb_event 為非零時,如果線程在處理要求之前終止,就會取消擱置的要求。 對於使用 ncb_post 傳送的要求而言,這並不成立。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | nb30.h |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |