2.2.17 _FAX_OUTBOX_CONFIG

The _FAX_OUTBOX_CONFIG data type is the custom-marshaled variant of the FAX_OUTBOX_CONFIG (section 2.2.16) data structure. The _FAX_OUTBOX_CONFIG data type is returned from the FAX_GetOutboxConfiguration (section 3.1.4.1.47) method.

This data structure is custom marshaled as follows and uses the custom-marshaling rules defined in section 2.2.1.

0	1	2	3	4	5	6	7	8	9	1 0	1	2	3	4	5	6	7	8	9	2 0	1	2	3	4	5	6	7	8	9	3 0	1
Fixed_Portion (36 bytes)
...
...
...

Fixed_Portion (36 bytes):

0	1	2	3	4	5	6	7	8	9	1 0	1	2	3	4	5	6	7	8	9	2 0	1	2	3	4	5	6	7	8	9	3 0	1
dwSizeOfStruct
bAllowPersonalCP
bUseDeviceTSID
dwRetries
dwRetryDelay
dtDiscountStart
dtDiscountEnd
dwAgeLimit
bBranding

dwSizeOfStruct (4 bytes): A DWORD ([MS-DTYP] section 2.2.9) that holds the size of the structure. MUST be set to 36 bytes.

bAllowPersonalCP (4 bytes): A Boolean that indicates whether fax client applications can include a user-designed cover page template with the fax transmission. If this field is TRUE, the client can provide a personal cover page template. If this field is FALSE, the client MUST use a common cover page template stored on the fax server.

bUseDeviceTSID (4 bytes): A Boolean variable that indicates whether the fax server can use the device's transmitting subscriber identifier instead of the value specified when a new job is submitted. If this field is TRUE, the server SHOULD use the device's transmitting subscriber identifier.

dwRetries (4 bytes): A DWORD that holds the number of times the fax server will attempt to retransmit an outgoing fax if the initial transmission fails.

dwRetryDelay (4 bytes): A DWORD that holds the minimum number of minutes that will elapse between retransmission attempts by the fax server.

dtDiscountStart (4 bytes): A FAX_TIME (section 2.2.61) structure that holds the hour and minute at which the discount period begins. The discount period applies only to outgoing transmissions.

dtDiscountEnd (4 bytes): A FAX_TIME that holds the hour and minute at which the discount period ends. The discount period applies only to outgoing transmissions.

dwAgeLimit (4 bytes): A DWORD variable that holds the number of days the fax server will keep unsuccessful fax messages in its outbox queue. If a fax message stays in the outbox queue longer than the value specified, it MAY be automatically deleted. If this value is zero, the time limit MUST NOT be used.

bBranding (4 bytes): A Boolean that indicates whether the fax server has to generate a brand (banner) at the top of outgoing fax transmissions. If this field is TRUE, the fax server generates a brand that contains transmission-related information such as the transmitting subscriber identifier, date, time, and page count.