FAX_COVERPAGE_INFOA-Struktur (winfax.h)

Artikel
08/27/2023

Die FAX_COVERPAGE_INFO-Struktur enthält Daten, die auf dem Deckblatt einer Faxübertragung angezeigt werden sollen. Die Member SizeOfStruct und CoverPageName sind erforderlich. andere Mitglieder sind optional.

Syntax

typedef struct _FAX_COVERPAGE_INFOA {
  DWORD      SizeOfStruct;
  LPCSTR     CoverPageName;
  BOOL       UseServerCoverPage;
  LPCSTR     RecName;
  LPCSTR     RecFaxNumber;
  LPCSTR     RecCompany;
  LPCSTR     RecStreetAddress;
  LPCSTR     RecCity;
  LPCSTR     RecState;
  LPCSTR     RecZip;
  LPCSTR     RecCountry;
  LPCSTR     RecTitle;
  LPCSTR     RecDepartment;
  LPCSTR     RecOfficeLocation;
  LPCSTR     RecHomePhone;
  LPCSTR     RecOfficePhone;
  LPCSTR     SdrName;
  LPCSTR     SdrFaxNumber;
  LPCSTR     SdrCompany;
  LPCSTR     SdrAddress;
  LPCSTR     SdrTitle;
  LPCSTR     SdrDepartment;
  LPCSTR     SdrOfficeLocation;
  LPCSTR     SdrHomePhone;
  LPCSTR     SdrOfficePhone;
  LPCSTR     Note;
  LPCSTR     Subject;
  SYSTEMTIME TimeSent;
  DWORD      PageCount;
} FAX_COVERPAGE_INFOA, *PFAX_COVERPAGE_INFOA;

Member

SizeOfStruct

Art: DWORD

Gibt die Größe der FAX_COVERPAGE_INFO-Struktur in Bytes an. Die aufrufende Anwendung muss diesen Member auf sizeof(FAX_COVERPAGE_INFO) festlegen.

CoverPageName

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die den Namen der Deckblattdatei (COV) darstellt, die dem empfangenen Faxdokument zugeordnet werden soll. Die Zeichenfolge kann der Dateiname der allgemeinen Deckblattdatei oder der UNC-Pfad zu einer lokalen Deckblattdatei sein.

UseServerCoverPage

Typ: BOOL

Gibt eine boolesche Variable an, die angibt, ob die Fax-Deckblattdatei auf dem lokalen Computer oder im allgemeinen Deckblattspeicherort gespeichert ist. Der Wert TRUE gibt an, dass sich die Deckblattdatei im allgemeinen Deckblattspeicherort auf dem Faxserver befindet.

RecName

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die den Namen des Empfängers der Faxübertragung angibt.

RecFaxNumber

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Faxnummer des Empfängers der Faxübertragung angibt.

RecCompany

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die den Firmennamen des Empfängers der Faxübertragung angibt.

RecStreetAddress

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Straßenadresse des Empfängers der Faxübertragung angibt.

RecCity

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die der Ort des Empfängers der Faxübertragung ist.

RecState

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die dem Zustand des Empfängers der Faxübertragung entspricht.

RecZip

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Postleitzahl des Empfängers der Faxübertragung darstellt.

RecCountry

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die das Land/die Region des Empfängers der Faxübertragung ist.

RecTitle

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die den Titel des Empfängers der Faxübertragung darstellt.

RecDepartment

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Abteilung des Empfängers der Faxübertragung ist.

RecOfficeLocation

Typ: LPCTSTR

Zeiger auf eine konstante NULL-beendete Zeichenfolge, die den Bürostandort des Empfängers der Faxübertragung darstellt.

RecHomePhone

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Privattelefonnummer des Empfängers der Faxübertragung darstellt.

RecOfficePhone

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Bürotelefonnummer des Empfängers der Faxübertragung darstellt.

SdrName

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die den Namen des Absenders darstellt, der die Faxübertragung initiiert hat.

SdrFaxNumber

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Faxnummer des Absenders darstellt, der die Faxübertragung initiiert hat.

SdrCompany

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die den Firmennamen des Absenders darstellt, der die Faxübertragung initiiert hat.

SdrAddress

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Adresse des Absenders ist, der die Faxübertragung initiiert hat.

SdrTitle

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die den Titel des Absenders darstellt, der die Faxübertragung initiiert hat.

SdrDepartment

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die den Abteilungsnamen des Absenders darstellt, der die Faxübertragung initiiert hat.

SdrOfficeLocation

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die den Bürostandort des Absenders darstellt, der die Faxübertragung initiiert hat.

SdrHomePhone

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Telefonnummer des Absenders darstellt, der die Faxübertragung initiiert hat.

SdrOfficePhone

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Bürotelefonnummer des Absenders darstellt, der die Faxübertragung initiiert hat.

Note

Typ: LPCTSTR

Zeiger auf eine konstante null-beendete Zeichenfolge, die den Text einer Nachricht oder Notiz vom Absender enthält, die sich auf die Faxübertragung bezieht. Der Text wird auf dem Deckblatt angezeigt.

Subject

Typ: LPCTSTR

Zeiger auf eine konstante NULL-Zeichenfolge, die die Betreffzeile der Faxübertragung darstellt.

TimeSent

Typ: SYSTEMTIME

Gibt eine SYSTEMTIME-Struktur an. Der Faxserver legt diesen Member fest, wenn er die Faxübertragung initiiert. Die Zeit wird in der lokalen Systemzeit angegeben.

PageCount

Art: DWORD

Gibt eine DWORD-Variable an, die die Gesamtanzahl der Seiten in der Faxübertragung angibt.

Hinweise

Eine Faxclientanwendung übergibt die FAX_COVERPAGE_INFO-Struktur in einem Aufruf an die FaxPrintCoverPage-Funktion . Dadurch kann ein Benutzer ein persönliches Deckblatt zu Beginn einer Faxübertragung drucken. Weitere Informationen finden Sie unter Deckblätter und Faxübertragung.

Hinweis

Der winfax.h-Header definiert FAX_COVERPAGE_INFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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