FAX_COVERPAGE_INFOA-Struktur (winfax.h)
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 |
Weitere Informationen
Faxdienst-Client-API-Strukturen