FAXCOM和FXSCOMEX 传真编程

需要引用的dl,如下信息，早起使用的是FXSCOM.DLL,现在微软提供了相应的扩展，其程序集为,FXSCOMEX.dll

FXSCOMEX.dll 提供跟加健全的方法，可以说所有关于传真的操作都在这个dll中。

以下是传真中使用的主要方法：

1. 首先定义一个封装传真人相关信息的Bean

  //定义传真需要封装的传真人相关的信息
   public  class FaxPeopleBean
     {
       public string Name;
       public string FaxNumber;
       public string Company;

       public DateTime ScheduleTime;

       public FaxPeopleBean()
       {
           ScheduleTime = QLOAParams.DtSqlDbMinValue;
       }
     }

　　2.　发送传真的方法

         public object sendFaxBatchDoc(FaxPeopleBean recipient, FaxPeopleBean sender, List<string> docList)
         {
             bool isConnected=false;
             FaxServer objFaxServer=null;
             try
             {
                 objFaxServer = new FaxServer();
                 FaxDocument objFaxDocument = new FaxDocument();
                 Object jobIds;//每次发送后，都会返回一个传真作业id,用于监控此传真的发送情况
                 //Connect to the fax server
                 objFaxServer.Connect(""); //""代表连接到本地机器服务，也可以使用其它网络传真服务器
                 isConnected = true;
                 SetOutgoingQueue(objFaxServer);
                 objFaxDocument.Sender.Name = sender.Name;
                 objFaxDocument.Sender.Company = sender.Company;
                 objFaxDocument.Sender.FaxNumber = sender.FaxNumber;
                 if (sender.ScheduleTime != QLOAParams.DtSqlDbMinValue)
                 {
                     // Specify that the fax is to be sent at a particular time
                     objFaxDocument.ScheduleType = FAXCOMEXLib.FAX_SCHEDULE_TYPE_ENUM.fstSPECIFIC_TIME;
                     //CDate converts the time to the Date data type
                     objFaxDocument.ScheduleTime = sender.ScheduleTime;
                 }

                 //Set the fax priority
                 objFaxDocument.Priority = FAXCOMEXLib.FAX_PRIORITY_TYPE_ENUM.fptHIGH;
                 // 'Add the recipient
                 objFaxDocument.Recipients.Add(recipient.FaxNumber, recipient.Name);
                 string[] files = docList.ToArray();
                 object bodys = files;
                 objFaxDocument.Bodies = bodys;
                 int result = objFaxDocument.ConnectedSubmit2(objFaxServer, out jobIds);
                 return jobIds;
             }
             finally
             {
                 if (isConnected && objFaxServer!=null)
                 {
                     objFaxServer.Disconnect();
                 }
             }
         }

　　3.　用于设置传真的一些属性，必须连接过后才可以设置

       public void SetOutgoingQueue(FaxServer objFaxServer)
        {
            FaxOutgoingQueue objFaxOutgoingQueue;
            //'Get the outgoing queue object
            objFaxOutgoingQueue = objFaxServer.Folders.OutgoingQueue;

            //'Refresh the queue object
            objFaxOutgoingQueue.Refresh();
            objFaxOutgoingQueue.Retries = ; //重试10次后不再发生
            objFaxOutgoingQueue.RetryDelay = ;

            //The Branding property is a Boolean value that indicates whether the fax service generates a brand (banner)
            //at the top of outgoing fax transmissions. A brand contains transmission-related information, such as the transmitting
            //station identifier, date, time, and page count.
            objFaxOutgoingQueue.Branding = true;
        }

　　4.　取消某个传真的发送

        public void CancelOutgoingQueue(string faxJobid)
        {
            FaxServer objFaxServer = new FaxServer();
            FaxOutgoingQueue objFaxOutgoingQueue;
            FaxOutgoingJob objFaxOutgoingJob;
            //'Connect to the fax server
            objFaxServer.Connect("");

            //'Get the outgoing queue object
            objFaxOutgoingQueue = objFaxServer.Folders.OutgoingQueue;
            //'Refresh the queue object
            objFaxOutgoingQueue.Refresh();

            try
            {
                objFaxOutgoingJob = (FaxOutgoingJob)objFaxOutgoingQueue.GetJob(faxJobid);               //找不到时会发生异常
                objFaxOutgoingJob.Cancel();
            }
            catch { }
            objFaxServer.Disconnect();
        }

　　5.　　需要对传真发送情况进行监控

FAXCOMEXLib.FaxServer _faxServer= new FaxServer();
            _faxServer.Connect("");
            _faxServer.OnOutgoingJobChanged +=FaxServer_OnOutgoingJobChanged;

 _faxServer.ListenToServerEvents( FAXCOMEXLib.FAX_SERVER_EVENTS_TYPE_ENUM.fsetFXSSVC_ENDED | FAXCOMEXLib.FAX_SERVER_EVENTS_TYPE_ENUM.fsetOUT_QUEUE;

　　6.　监控的方法在这里

     public void FaxServer_OnOutgoingJobChanged(FAXCOMEXLib.IFaxServer pFaxServer, string bstrJobId, FAXCOMEXLib.IFaxJobStatus pJobStatus)
        {

　　　　　　　　//根据pJobStatus 枚举可以实时的获取，传真的发生情况，具体的操作代码可以写作这里

　　　　　}