C++Builder NetBIOS 程式設計：從基礎到實作範例

什麼是 NetBIOS？

NetBIOS (Network Basic Input/Output System) 是 IBM 於 1984 年為 PC Network 定義的 API，提供工作階層 (Session Layer) 的網路通訊介面。雖然古老，但在區域網路 (LAN) 環境下仍廣泛用於舊系統相容、簡易訊息傳遞、名稱解析。Windows 內建 Netbios() 函數 (在 nb30.h/netbios.h) 供應用程式呼叫。

核心概念

常用命令碼

NCBRESET       (0x32)  重設介面卡，清除名稱表、斷開所有工作階段
NCBASTAT       (0x33)  取得介面卡狀態 (MAC 位址、名稱表、錯誤計數)
NCBADDNAME     (0x30)  註冊本地名稱
NCBDELNAME     (0x31)  刪除本地名稱
NCBCALL        (0x10)  發起工作階段連線
NCBLISTEN      (0x11)  側聽工作階段請求
NCBSEND        (0x14)  工作階段傳送資料
NCBRECV        (0x15)  工作階段接收資料
NCBHANGUP      (0x12)  關閉工作階段
NCBSENDDG      (0x20)  發送定向資料報
NCBRECVDG      (0x21)  接收定向資料報
NCBSENDBC      (0x22)  發送廣播資料報
NCBRECVBC      (0x23)  接收廣播資料報

NCB 結構關鍵欄位

typedef struct _NCB {
    UCHAR  ncb_command;      // 命令碼 (高位元=1 表非同步)
    UCHAR  ncb_retcode;      // 返回碼 (0=成功，其他見下表)
    UCHAR  ncb_lsn;          // 本地工作階段號 (由系統指派)
    UCHAR  ncb_num;          // 名稱號碼 (Add Name 後取得)
    PUCHAR ncb_buffer;       // 資料緩衝區指標
    WORD   ncb_length;       // 緩衝區長度
    UCHAR  ncb_callname[16]; // 遠端名稱 (Call/SendDG 目標)
    UCHAR  ncb_name[16];     // 本地名稱
    UCHAR  ncb_rto;          // 接收逾時 (單位: 500ms)
    UCHAR  ncb_sto;          // 發送逾時 (單位: 500ms)
    void  (*ncb_post)(struct _NCB*); // 非同步完成回呼
    UCHAR  ncb_lana_num;     // LANA 號
    UCHAR  ncb_cmd_cplt;     // 命令完成碼 (0xFF=進行中)
    UCHAR  ncb_reserve[10];  // 保留
    HANDLE ncb_event;        // 非同步事件控制代碼
} NCB;

常見返回碼

完整範例：取得本機 MAC 位址與名稱表 (NCBASTAT)

// NetBIOS_MAC.cpp - C++Builder Console App
#pragma hdrstop
#include <windows.h>
#include <nb30.h>        // NetBIOS 定義
#include <stdio.h>
#include <conio.h>

// 適配器狀態緩衝區 (NCBASTAT 回傳)
typedef struct _ASTAT {
    ADAPTER_STATUS adapt;
    NAME_BUFFER    NameBuff[30];
} ASTAT, *PASTAT;

bool ResetAdapter(UCHAR lana) {
    NCB ncb = {0};
    ncb.ncb_command = NCBRESET;
    ncb.ncb_lana_num = lana;
    return Netbios(&ncb) == NRC_GOODRET;
}

int main() {
    UCHAR lana = 0; // 通常 0 為第一張網卡
    if (!ResetAdapter(lana)) {
        printf("重設介面卡失敗\\n");
        getch(); return 1;
    }

    NCB ncb = {0};
    ncb.ncb_command  = NCBASTAT;
    ncb.ncb_lana_num = lana;
    ncb.ncb_callname[0] = '*'; // '*' 表示查詢本機
    for (int i = 1; i < 16; ++i) ncb.ncb_callname[i] = ' ';

    ASTAT Adapter = {0};
    ncb.ncb_buffer = (PUCHAR)&Adapter;
    ncb.ncb_length = sizeof(Adapter);

    UCHAR ret = Netbios(&ncb);
    printf("NCBASTAT 返回碼: 0x%02X\\n", ret);

    if (ret == NRC_GOODRET) {
        // MAC 位址
        printf("MAC 位址: ");
        for (int i = 0; i < 6; ++i) {
            printf("%02X%c", Adapter.adapt.adapter_address[i], (i==5?'\n':'-'));
        }
        // 介面卡類型
        if (Adapter.adapt.adapter_type == 0xFF) printf("Token Ring\\n");
        else if (Adapter.adapt.adapter_type == 0xFE) printf("Ethernet\\n");
        else printf("其他 (0x%02X)\\n", Adapter.adapt.adapter_type);

        // 軟體版本
        printf("軟體版本: %d.%d\\n", Adapter.adapt.rev_major, Adapter.adapt.rev_minor);
        // 本地名稱表
        printf("本地名稱數: %d\\n", Adapter.adapt.name_count);
        for (int i = 0; i < Adapter.adapt.name_count; ++i) {
            char name[17] = {0};
            memcpy(name, Adapter.NameBuff[i].name, 16);
            printf("  [%02d] %s (num=%d, flags=0x%02X)\\n",
                   i, name, Adapter.NameBuff[i].name_num, Adapter.NameBuff[i].name_flags);
        }
    }
    getch();
    return 0;
}

編譯與執行注意事項

• 專案需連結 netapi32.lib (隱含由 nb30.h 引入)。
• Windows 10/11 預設停用 NetBIOS over TCP/IP，需在網卡屬性 → IPv4 進階 → WINS → 啟用「NetBIOS over TCP/IP」或透過登錄 HKLM\SYSTEM\CurrentControlSet\Services\NetBT\Parameters\Interfaces\Tcpip_{GUID} 設定 NetbiosOptions=1。
• 需系統管理員權限 執行 (存取裝置驅動)。
• 64 位元應用程式同樣適用，Netbios() 為 32/64 位元通用。

現代替代方案

結語

NetBIOS 是網路程式設計的歷史遺產，理解其 NCB 架構、同步/非同步模式、名稱管理、工作階段與資料報差異，有助於維護舊系統。新專案強烈建議採用標準 TCP/IP Socket 或更高層級框架，獲得跨平台、可擴展、安全的通訊能力。

1. 上一篇文章： C++ 核心筆記 (一)：類別與物件基礎完整指南
2. 下一篇文章： C++Builder 5 ADO 資料庫程式設計：從元件架構到 Master/Detail 實作

關於C++

HDU 1431 素數回文：範圍預生成 + 素性測試

HDU 1431 素數回文 詳解 題目：多組查詢，每組給 a

設計模式實作系列（十一）：Template Method 模板方法模式 - 定義演算法骨架延遲步驟至子類實作

模式意圖 定義一個操作中的演算法骨架，將某些步驟延遲到子類中

Win32 API 實作 2048 遊戲完整教學與原始碼解析

前言 2048 是一款風靡全球的數字益智遊戲，規則簡單卻極具

C++ 對象指針完整指南：從基礎到進階應用

前言 在 C++ 程式設計中，指針是核心機制之一，而「對象指