共用方式為

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 回到其呼叫端時，異步命令仍然擱置中，則傳回值為零。
如果 pncb 參數指定的位址無效，則傳回值 會NRC_BADNCB。

如果 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

另請參閱

NCB