FAX_RECEIVE結構 (faxdev.h)

FAX_RECEIVE結構包含輸入傳真檔的相關資訊。 此資訊包括將接收傳真資料流程的檔案名,以及接收裝置的名稱和電話號碼。

語法

typedef struct _FAX_RECEIVE {
  DWORD  SizeOfStruct;
  LPWSTR FileName;
  LPWSTR ReceiverName;
  LPWSTR ReceiverNumber;
  DWORD  Reserved[4];
} FAX_RECEIVE, *PFAX_RECEIVE;

成員

SizeOfStruct

類型: DWORD

指定 FAX_RECEIVE 結構的大小,以位元組為單位。 呼叫 FaxDevReceive 函 式之前,傳真服務會將此成員設定為 sizeof (FAX_RECEIVE) 。 如需詳細資訊,請參閱接下來的<備註>一節。

FileName

類型: LPWSTR

Null 終止 Unicode 字元字串的指標,指定 FSP 必須儲存輸入傳真檔資料流程之檔案的完整路徑。 資料流程是 TIFF 類別 F 檔案。 如需詳細資訊,請參閱 傳真圖像格式。 傳真服務會在呼叫 FaxDevReceive 函式之前建立檔案。 開啟此檔案時,FSP 必須指定OPEN_EXISTING旗標。

ReceiverName

類型: LPWSTR

指定接收裝置名稱之 Null 終止 Unicode 字元字串的指標。 FSP 會在接收裝置收到輸入傳真之後,將名稱傳送至遠端傳送裝置。 如需詳細資訊,請參閱接下來的<備註>一節。

ReceiverNumber

類型: LPWSTR

指定接收裝置電話號碼之 Null 終止 Unicode 字元字串的指標。 FSP 會在接收裝置收到輸入傳真之後,將號碼傳送至遠端傳送裝置。 如需詳細資訊,請參閱接下來的<備註>一節。

Reserved[4]

類型: DWORD

此成員會保留給 Microsoft 未來使用。 它必須設定為零。

備註

FSP 必須在此結構中設定 ReceiverNameReceiverNumber 成員。 傳真服務會為這些字串配置記憶體。 服務配置的記憶體大小等於 sizeof (FAX_RECEIVE) + FAXDEVRECEIVE_SIZE。 FSP 必須將字串放在 FAX_RECEIVE結構的記憶體 區塊中。 請注意,您必須允許緊接在FAX_RECEIVE結構之後的FileName字串大小。 ReceiverNameReceiverNumber成員必須指向記憶體區塊中字串的位置。

下列程式碼範例和圖表說明如何填入傳真服務配置的記憶體。

PWSTR ReceiverName;
PWSTR ReceiverNumber;

//
// Routine to retrieve the receiver name
//   and receiver number here.

//
// Set the receiver name and receiver number data
//  in the FAX_RECEIVE structure; then
//  copy the data to the appropriate offset.
//
FaxReceive->ReceiverNumber = (LPWSTR) ( (LPBYTE)FaxReceive->FileName + sizeof(WCHAR)*(wcslen(FaxReceive->FileName) + 1));
wcscpy_s(  FaxReceive->ReceiverNumber, ReceiverNumber );

FaxReceive->ReceiverName = (LPWSTR) ( (LPBYTE)FaxReceive->ReceiverNumber+ sizeof(WCHAR)*(wcslen(FaxReceive->ReceiverNumber) + 1));
wcscpy_s(  FaxReceive->ReceiverName, ReceiverName );

填入傳真服務配置的記憶體 FSP 可以將 ReceiverNameReceiverNumber 成員重新格式化,並將重新格式化的資料傳送至遠端傳送裝置,作為稱為訂閱者識別碼 (CSI) ,以符合來自研究群組 8 (SG8) 之 INTERNATIONAL Telecommunication Union () 標準主體的建議。 如需詳細資訊,請參閱FAX_DEV_STATUS結構的RoutingInfoCSI成員。

規格需求

   
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 faxdev.h

另請參閱

FAX_DEV_STATUS

傳真服務提供者結構

FaxDevReceive

使用傳真服務提供者 API