FAX_SEND-Struktur (faxdev.h)

Die FAX_SEND-Struktur enthält Informationen zu einem ausgehenden Faxdokument. Die Struktur enthält den Namen der Datei, die den Faxdatenstrom enthält, den Namen und die Telefonnummer des anrufenden Geräts sowie den Namen und die Telefonnummer des empfangenden Geräts.

Syntax

typedef struct _FAX_SEND {
  DWORD  SizeOfStruct;
  LPWSTR FileName;
  LPWSTR CallerName;
  LPWSTR CallerNumber;
  LPWSTR ReceiverName;
  LPWSTR ReceiverNumber;
  BOOL   Branding;
  HCALL  CallHandle;
  DWORD  Reserved[3];
} FAX_SEND, *PFAX_SEND;

Member

SizeOfStruct

Art: DWORD

Gibt die Größe der FAX_SEND-Struktur in Bytes an. Vor dem Aufrufen der FaxDevSend-Funktion legt der Faxdienst diesen Member auf sizeof(FAX_SEND) fest.

FileName

Typ: LPWSTR

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den vollständigen Pfad zu der Datei angibt, die den Datenstrom für ein ausgehendes Faxdokument enthält. Der Datenstrom ist eine TIFF-Datei der Klasse F. Weitere Informationen finden Sie unter Faxbildformat.

CallerName

Typ: LPWSTR

Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den Namen des aufrufenden Geräts angibt. Der FSP sendet diesen Namen an das Remoteempfangsgerät, wenn der FSP das Fax sendet. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

CallerNumber

Typ: LPWSTR

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die Telefonnummer des anrufenden Geräts angibt. (Diese Nummer ist auch die TSID.) Der FSP sendet diese Nummer an das Remoteempfangsgerät, wenn der FSP das Fax sendet. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

ReceiverName

Typ: LPWSTR

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Geräts angibt, das das ausgehende Faxdokument empfangen wird.

ReceiverNumber

Typ: LPWSTR

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die Telefonnummer des Geräts angibt, das das ausgehende Faxdokument empfangen wird. Dies ist die Telefonnummer, die der FSP wählt.

Wenn Sie das CallHandle-Element angeben, muss das ReceiverNumber-ElementNULL sein.

Branding

Typ: BOOL

Reserviert.

CallHandle

Typ: HCALL

Reserviert; muss auf NULL festgelegt werden.

Reserved[3]

Art: DWORD

Dieses Mitglied ist von Microsoft reserviert. Er muss auf 0 (null) festgelegt werden.

Hinweise

Der FSP kann die Member CallerName und CallerNumber neu formatieren. Der FSP kann dann die neu formatierten Daten als sogenannten Abonnentenbezeichner (CSI) an das Remote-Sendegerät übertragen, um der Empfehlung des Standards body of the International Telecommunication Union (ITU) der Studiengruppe 8 (SG8) zu entsprechen. Weitere Informationen finden Sie in den RoutingInfo - und CSI-Membern der FAX_DEV_STATUS-Struktur .

Der FSP kann auch die neu formatierten Daten verwenden, um der Faxübertragung eine Marke hinzuzufügen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	faxdev.h

Weitere Informationen

FAX_DEV_STATUS

Strukturen des Faxdienstanbieters

FaxDevSend

LINE_CALLSTATE

Verwenden der Faxdienstanbieter-API