C# 發送傳真實現：基於 FAXCOMLib 的完整方案

技術方案概覽

Windows 自帶傳真服務，通過 COM 組件 FAXCOMLib (faxcom.dll) 開發發送傳真功能。需目標機器安裝傳真組件、配置傳真設備/調制解調器、啟動傳真服務。

環境準備

1. Windows 功能 → 「打印和文檔服務」 → 「傳真服務」啟用
2. 控制面板 → 「電話和調制解調器」配置傳真調制解調器
3. 服務 (services.msc) 確保 Fax 服務運行
4. VS 專案 → 添加引用 → COM → Microsoft Fax Service Extended COM Component 1.0 Type Library (生成 Interop.FAXCOMLib.dll)

核心發送代碼

using System;
using System.IO;
using FAXCOMLib; // Interop 命名空間

public class FaxSender
{
    public bool SendFax(string filePath, string faxNumber, string serverName = "")
    {
        if (!File.Exists(filePath))
            throw new FileNotFoundException("傳真文件不存在", filePath);

        FaxServerClass server = null;
        FaxDocClass doc = null;
        
        try
        {
            // 1. 連接傳真服務器 (本機傳空字符串或 ".")
            server = new FaxServerClass();
            server.Connect(serverName); // 遠程服務器需權限
            
            // 2. 創建傳真文檔 (支持 TIFF, PDF 等傳真服務支持的格式)
            doc = (FaxDocClass)server.CreateDocument(filePath);
            
            // 3. 設置收件人信息
            doc.RecipientName = "收件人姓名";
            doc.FaxNumber = faxNumber; // 格式: "010-12345678" 或 "@tapi\..." 
            doc.RecipientCompany = "公司名";
            // 可選: doc.RecipientAddress, .City, .State, .Zip, .Country, .Title, .Department, .OfficeLocation, .HomePhone, .OfficePhone
            
            // 4. 設置發件人信息 (顯示在傳真頁眉/封面)
            doc.SenderName = "發件人";
            doc.SenderCompany = "我方公司";
            doc.SenderFax = "010-87654321";
            doc.SenderAddress = "地址";
            // 可選: .Title, .Department, .OfficePhone, .HomePhone, .Email, .BillingCode
            
            // 5. 封面頁設置 (可選)
            // doc.CoverpageName = "Modern"; // 系統內置封面模板名
            // doc.CoverpageSubject = "主題";
            // doc.CoverpageNote = "備註";
            // doc.ServerCoverpage = true; // 使用服務器端封面
            
            // 6. 發送
            int jobId = doc.Send(); // 返回傳真作業 ID
            
            Console.WriteLine($"傳真提交成功，JobId: {jobId}");
            return true;
        }
        catch (Exception ex)
        {
            Console.WriteLine($"發送失敗: {ex.Message}");
            // 記錄詳細錯誤: ex.ErrorCode (HRESULT), 內部異常
            return false;
        }
        finally
        {
            // 釋放 COM 對象
            if (doc != null) Marshal.ReleaseComObject(doc);
            if (server != null) 
            {
                server.Disconnect();
                Marshal.ReleaseComObject(server);
            }
        }
    }
}

關鍵參數說明

狀態監控與錯誤處理

// 查詢作業狀態
FaxJobStatusEnum status = server.GetJobStatus(jobId);
// 枚舉: fjsQUEUED, fjsINPROGRESS, fjsCOMPLETED, fjsFAILED, fjsCANCELED, fjsBLOCKED

// 事件訂閱 (需實現 IFaxServerNotify 接口，較複雜)
// 簡單輪詢:
while (true)
{
    var status = server.GetJobStatus(jobId);
    if (status == FaxJobStatusEnum.fjsCOMPLETED) { /* 成功 */ break; }
    if (status == FaxJobStatusEnum.fjsFAILED) { /* 失敗，獲取 ExtendedStatus */ break; }
    Thread.Sleep(5000);
}

常見問題排查

現代替代方案

1. 雲傳真 API：Twilio Fax, eFax API, InterFAX, SRFax — 無硬件、按量付費、REST API、高可用
2. Email-to-Fax 网关：郵件發送到 number@faxprovider.com 自動轉傳真
3. 虛擬調制解調器 + HylaFax (Linux)：服務器端部署，應用通過 FTP/HTTP 提交 TIFF

總結

FAXCOMLib 是 Windows 平台原生發送傳真的標準方式，適合已有傳真硬件、內網環境、合規要求數據不出局域網的場景。代碼核心在於正確配置 FaxServer 連接、構建 FaxDoc 屬性、處理 COM 異常與資源釋放。新項目強烈建議評估雲傳真服務，降低維護成本並提高送達率。