<div class="content" name="FAX_GENERAL_CONFIG" uuid="7b87f66e-e7bf-4294-be2f-669de0595bde"><p>The <b>FAX_GENERAL_CONFIG</b> data type can be passed as a
byte–array parameter to <b>FAX_SetGeneralConfiguration</b> (section <a href="34e02038-9f56-4c51-abfa-e404cf3b2ffd" data-linktype="relative-path">3.1.4.1.80</a>) and <b>FAX_GetGeneralConfiguration</b>
(section <a href="660b4d98-8a20-4391-a232-ca6608e6154f" data-linktype="relative-path">3.1.4.1.40</a>) to
change or to return the current fax server configuration settings.</p><p>This data structure is custom marshaled as follows and uses
the custom-marshaling rules defined in section <a href="a660ed3e-062f-4b49-ab5b-0ba19ea7598d" data-linktype="relative-path">2.2.1</a>.</p><table>
 <tbody><tr>
  <th><p><br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>1<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>2<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>3<br/>0</p></th>
  <th><p><br/>1</p></th>
 </tr>
 <tr>
  <td colspan="32">Fixed_Portion (88 bytes)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">Variable_Data (variable)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
</tbody></table><p><b>Fixed_Portion (88 bytes):</b></p><dl>
<dd>
<table>
 <tbody><tr>
  <th><p><br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>1<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>2<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>3<br/>0</p></th>
  <th><p><br/>1</p></th>
 </tr>
 <tr>
  <td colspan="32">dwSizeOfStruct</td>
 </tr>
 <tr>
  <td colspan="32">bUseArchive</td>
 </tr>
 <tr>
  <td colspan="32">lpcwstrArchiveLocationOffset</td>
 </tr>
 <tr>
  <td colspan="32">bSizeQuotaWarning</td>
 </tr>
 <tr>
  <td colspan="32">dwSizeQuotaHighWaterMark</td>
 </tr>
 <tr>
  <td colspan="32">dwSizeQuotaLowWaterMark</td>
 </tr>
 <tr>
  <td colspan="32">dwArchiveAgeLimit</td>
 </tr>
 <tr>
  <td colspan="32">Padding</td>
 </tr>
 <tr>
  <td colspan="32">dwlArchiveSize</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">dwQueueAgeLimit</td>
 </tr>
 <tr>
  <td colspan="32">dwRetries</td>
 </tr>
 <tr>
  <td colspan="32">dwRetryDelay</td>
 </tr>
 <tr>
  <td colspan="32">bUseDeviceTSID</td>
 </tr>
 <tr>
  <td colspan="32">Fixed_Portion of dtDiscountStart</td>
 </tr>
 <tr>
  <td colspan="32">Fixed_Portion of dtDiscountEnd</td>
 </tr>
 <tr>
  <td colspan="32">bBranding</td>
 </tr>
 <tr>
  <td colspan="32">bAllowPersonalCP</td>
 </tr>
 <tr>
  <td colspan="32">dwQueueState</td>
 </tr>
 <tr>
  <td colspan="32">bAutoCreateAccountOnConnect</td>
 </tr>
 <tr>
  <td colspan="32">bIncomingFaxesArePublic</td>
 </tr>
 <tr>
  <td colspan="32">Padding</td>
 </tr>
</tbody></table>
</dd>
<dd>
<p><b>dwSizeOfStruct (4 bytes):
</b>A <b>DWORD</b> (<a href="../ms-dtyp/cca27429-5689-4a16-b2b4-9325d93e4ba2" data-linktype="relative-path">[MS-DTYP]</a>
section <a href="../ms-dtyp/262627d8-3418-4627-9218-4ffe110850b2" data-linktype="relative-path">2.2.9</a>)
value containing the size, in bytes, of the structure. MUST be set to 88 bytes.</p>
</dd>
<dd>
<p><b>bUseArchive (4 bytes): </b>A
Boolean value that indicates whether the fax server uses an <a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_9394bf31-7db9-433c-8d3d-ee6a37bf0848" data-linktype="relative-path">archive</a> to store fax
messages after they are successfully sent or received. If this field is TRUE,
the fax server MUST archive fax messages. This flag corresponds to the <b>Archive
Enabled</b> fax server configuration setting (section <a href="bd422bcf-7ce8-4576-addb-89345ea84f9f" data-linktype="relative-path">3.1.1</a>).</p>
</dd>
<dd>
<p><b>lpcwstrArchiveLocationOffset
(4 bytes): </b>Offset to the <b>lpcwstrArchiveLocation</b> field in the <b>Variable_Data</b>
block of the structure.</p>
</dd>
<dd>
<p><b>bSizeQuotaWarning (4
bytes): </b>A Boolean value that indicates whether the fax server MAY issue an
implementation-specific warning if the archive quota exceeds the watermarks
defined by the <b>dwSizeQuotaHighWatermark</b> and <b>dwSizeQuotaLowWatermark</b>
fields. If this field is TRUE, the fax server can issue an
implementation-specific warning. This flag configures the <b>size quota warning</b>
fax server configuration setting (section 3.1.1).</p>
</dd>
<dd>
<p><b>dwSizeQuotaHighWaterMark
(4 bytes): </b>A <b>DWORD</b> value that holds the current value of the fax
server configuration setting (section 3.1.1). If the size of the archive
exceeds this value, and if the <b>bSizeQuotaWarning</b> field is set to TRUE,
an implementation-specific warning can be issued.</p>
</dd>
<dd>
<p><b>dwSizeQuotaLowWaterMark
(4 bytes): </b>A <b>DWORD</b> value that holds the current value of the <b>size
quota low watermark</b> fax server configuration setting (section 3.1.1). If
the size of the archive falls below this value, and if the <b>bSizeQuotaWarning</b>
field is set to TRUE, an implementation-specific warning can be issued.</p>
</dd>
<dd>
<p><b>dwArchiveAgeLimit (4
bytes): </b>A <b>DWORD</b> value that holds the current value of the <b>Archive
Age Limit</b> fax server configuration setting (section 3.1.1).</p>
</dd>
<dd>
<p><b>Padding (4 bytes): </b>Padding
for data alignment to an 8-byte boundary.</p>
</dd>
<dd>
<p><b>dwlArchiveSize (8 bytes):
</b>A <b>DWORDLONG</b> ([MS-DTYP] section <a href="../ms-dtyp/c575fb47-166c-48cd-a37c-e44cac05c3d6" data-linktype="relative-path">2.2.13</a>)
value that holds the actual size of the archived data contained in the <b>Fax
Archive Folder</b> (section 3.1.1).</p>
</dd>
<dd>
<p><b>dwQueueAgeLimit (4
bytes): </b>A <b>DWORD</b> value that specifies the current <b>queue age limit</b>
fax server configuration setting (section 3.1.1). For an outgoing fax job,
after this period elapses for a fax job and the fax job is still not
transmitted to its destination, the fax server SHOULD delete the respective fax
job from the outgoing <a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_0c5e7185-40c3-4e58-a8ac-7626ed078235" data-linktype="relative-path">fax
queue</a>. For an incoming fax job, after this period elapses for a fax job, the
fax server SHOULD delete the respective fax job from the incoming fax queue. If
<b>bUseArchive</b> is TRUE, meaning that the <b>Archive Enabled</b> fax server
configuration setting is enabled, the fax server SHOULD archive incoming and
outgoing fax messages regardless of whether the time period described by this
value (for the <b>queue age limit</b> fax server configuration setting)
elapses.</p>
</dd>
<dd>
<p><b>dwRetries (4 bytes): </b>A
<b>DWORD</b> value that specifies the current value of the <b>fax transmission
retries</b> fax server configuration setting (section 3.1.1).</p>
</dd>
<dd>
<p><b>dwRetryDelay (4 bytes): </b>A
<b>DWORD</b> value that specifies the current value of the <b>fax transmission
retry delay</b> fax server configuration setting (section 3.1.1).</p>
</dd>
<dd>
<p><b>bUseDeviceTSID (4 bytes):
</b>A Boolean value that specifies the current value of the <b>use device&#39;s
TSID</b> fax server configuration setting (section 3.1.1).</p>
</dd>
<dd>
<p><b>Fixed_Portion of
dtDiscountStart (4 bytes): </b>The <b>Fixed_Portion</b> block of a <b>FAX_TIME</b>
(section <a href="eb612891-9092-4f9c-a975-db41229afe41" data-linktype="relative-path">2.2.61</a>)
structure that holds the hour and minute values of the <b>start cheap time</b>
fax server configuration setting (section 3.1.1).</p>
</dd>
<dd>
<p><b>Fixed_Portion of
dtDiscountEnd (4 bytes): </b>The <b>Fixed_Portion</b> block of a <b>FAX_TIME</b>
that holds the hour and minute values of the <b>stop cheap time</b> fax server
configuration setting (section 3.1.1).</p>
</dd>
<dd>
<p><b>bBranding (4 bytes): </b>A
Boolean value that specifies the current value of the <b>Branding</b> server
configuration setting (section 3.1.1). If this field is TRUE, the fax server
SHOULD generate an implementation-specific brand that contains
transmission-related information, such as the <a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_3b1ad462-95fc-4739-b942-4a5670d6ae34" data-linktype="relative-path">transmitting subscriber identifier</a>,
date, time, and page count.</p>
</dd>
<dd>
<p><b>bAllowPersonalCP (4
bytes): </b>A Boolean value that specifies the current value of the <b>personal
cover page support</b> fax server configuration setting (section 3.1.1). 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.</p>
</dd>
<dd>
<p><b>dwQueueState (4 bytes): </b>A
<b>DWORD</b> value that contains the current value of the <b>Queue State</b>
(section 3.1.1). If this value is zero, both the incoming and outgoing <a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_c1a6400d-703b-4f9a-a74c-40f1487978d9" data-linktype="relative-path">queues</a> MUST be unblocked;
otherwise, this value MUST be a combination of one or more of the following
flags.</p>
<dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value/code</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>FAX_INCOMING_BLOCKED 0x00000001</td>
  <td>Fax service will not receive new incoming faxes.</td>
 </tr><tr>
  <td>FAX_OUTBOX_BLOCKED 0x00000002</td>
  <td>Fax service will reject submissions of new outgoing faxes to its queue.</td>
 </tr><tr>
  <td>FAX_OUTBOX_PAUSED 0x00000004</td>
  <td>Fax service will not remove and execute outgoing fax jobs from its queue.</td>
 </tr></tbody></table>
</dd></dl></dd>
<dd>
<p><b>bAutoCreateAccountOnConnect
(4 bytes): </b>A Boolean value that contains the current value of the <b>Automatic
Account Creation</b> fax server configuration setting (section 3.1.1). A value
of TRUE indicates that the setting is enabled; FALSE means that the setting is
disabled. For more details, see section <a href="5cbfd38d-7a14-4560-ad24-9ed78f19a3bb" data-linktype="relative-path">3.1.4.1.10</a>.</p>
</dd>
<dd>
<p><b>bIncomingFaxesArePublic
(4 bytes): </b>A Boolean value that contains the current value of the <b>incoming
fax viewing permission</b> setting (section 3.1.1). When this setting is TRUE,
all incoming faxes SHOULD be accessible for viewing by all users. When it is
FALSE, only users whose accounts have FAX_ACCESS_MANAGE_RECEIVE_FOLDER
permission MUST be able to view the incoming faxes.</p>
</dd>
<dd>
<p><b>Padding (4 bytes): </b>Padding
for data alignment to an 8-byte boundary.</p>
</dd></dl><p><b>Variable_Data (variable):</b></p><dl>
<dd>
<table>
 <tbody><tr>
  <th><p><br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>1<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>2<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>3<br/>0</p></th>
  <th><p><br/>1</p></th>
 </tr>
 <tr>
  <td colspan="32">lpcwstrArchiveLocation (variable)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
</tbody></table>
</dd>
<dd>
<p><b>lpcwstrArchiveLocation
(variable): </b>A null-terminated character string that indicates the archives
folder location on the fax server file system. The portion preceding the
terminating null character of this string MUST NOT end in a backslash (\)
character.</p>
</dd></dl></div>