FAX_COVERPAGE_INFOA structure

The FAX_COVERPAGE_INFO structure contains data to display on the cover page of a fax transmission. The SizeOfStruct and CoverPageName members are required; other members are 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;

Members

        `SizeOfStruct`

        Type: <b>DWORD</b>

Specifies the size, in bytes, of the FAX_COVERPAGE_INFO structure. The calling application must set this member to sizeof(FAX_COVERPAGE_INFO).

        `CoverPageName`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the name of the cover page file (.cov) to associate with the received fax document. The string can be the file name of the common cover page file, or it can be the UNC path to a local cover page file.

        `UseServerCoverPage`

        Type: <b>BOOL</b>

Specifies a Boolean variable that indicates whether the fax cover page file is stored on the local computer or in the common cover page location. A value of TRUE indicates that the cover page file resides in the common cover page location on the fax server.

        `RecName`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that specifies the name of the recipient of the fax transmission.

        `RecFaxNumber`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that specifies the fax number of the recipient of the fax transmission.

        `RecCompany`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that specifies the company name of the recipient of the fax transmission.

        `RecStreetAddress`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that specifies the street address of the recipient of the fax transmission.

        `RecCity`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the city of the recipient of the fax transmission.

        `RecState`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the state of the recipient of the fax transmission.

        `RecZip`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the postal ZIP code of the recipient of the fax transmission.

        `RecCountry`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the country/region of the recipient of the fax transmission.

        `RecTitle`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the title of the recipient of the fax transmission.

        `RecDepartment`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the department of the recipient of the fax transmission.

        `RecOfficeLocation`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the office location of the recipient of the fax transmission.

        `RecHomePhone`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the home telephone number of the recipient of the fax transmission.

        `RecOfficePhone`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the office telephone number of the recipient of the fax transmission.

        `SdrName`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the name of the sender who initiated the fax transmission.

        `SdrFaxNumber`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the fax number of the sender who initiated the fax transmission.

        `SdrCompany`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the company name of the sender who initiated the fax transmission.

        `SdrAddress`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the address of the sender who initiated the fax transmission.

        `SdrTitle`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the title of the sender who initiated the fax transmission.

        `SdrDepartment`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the department name of the sender who initiated the fax transmission.

        `SdrOfficeLocation`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the office location of the sender who initiated the fax transmission.

        `SdrHomePhone`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the home telephone number of the sender who initiated the fax transmission.

        `SdrOfficePhone`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the office telephone number of the sender who initiated the fax transmission.

        `Note`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that contains the text of a message or note from the sender that pertains to the fax transmission. The text will appear on the cover page.

        `Subject`

        Type: <b>LPCTSTR</b>

Pointer to a constant null-terminated character string that is the subject line of the fax transmission.

        `TimeSent`

        Type: <b><a href="https://docs.microsoft.com/windows/desktop/api/minwinbase/ns-minwinbase-systemtime">SYSTEMTIME</a></b>

Specifies a SYSTEMTIME structure. The fax server sets this member when it initiates the fax transmission. The time is expressed in local system time.

        `PageCount`

        Type: <b>DWORD</b>

Specifies a DWORD variable that indicates the total number of pages in the fax transmission.

## Remarks
    A fax client application passes the <b>FAX_COVERPAGE_INFO</b> structure in a call to the <a href="https://docs.microsoft.com/previous-versions/windows/desktop/api/winfax/nf-winfax-faxprintcoverpagea">FaxPrintCoverPage</a> function. This enables a user to print a personal cover page at the beginning of a fax transmission. For more information, see <a href="https://docs.microsoft.com/previous-versions/windows/desktop/fax/-mfax-cover-pages">Cover Pages</a> and <a href="https://docs.microsoft.com/previous-versions/windows/desktop/fax/-mfax-transmitting-faxes">Transmitting Faxes</a>.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header winfax.h
## See Also

    <a href="https://docs.microsoft.com/previous-versions/windows/desktop/fax/-mfax-fax-service-client-api-structures">Fax Service Client API Structures</a>

Fax Service Client API for Windows 2000

FaxCompleteJobParams

FaxPrintCoverPage

FaxSendDocument

SYSTEMTIME