<div class="content"><p>The GenerateTimeSpanLog method writes a file that contains
diagnostic information about <a href="b30bcd1c-8ff6-46d2-a27e-61bd85ace9f4#gt_acd8b49c-8762-48fd-9272-26a03643322b" data-linktype="relative-path">failover
clusters</a> for the server on which it executes. The log entries in the file
date back only for the specified number of minutes. The content and format of
the file is implementation-specific, but SHOULD contain diagnostic information.</p><dl>
<dd>
<div><pre> HRESULT GenerateTimeSpanLog(
   [in] unsigned long SpanMinutes,
   [out] BSTR* LogFilePath
 );
</pre></div>
</dd></dl><p><b>SpanMinutes: </b>A value, in minutes, that
indicates those values that SHOULD be in the log. Events that occurred in the
range of <b>Now</b> to (<b>Now</b> - <i>SpanMinutes</i>) MUST be in the log and
no others. <b>Now</b> is the GMT on the server.</p><p><b>LogFilePath: </b>Has the same meaning as parameter
<i>LogFilePath</i> for the <a href="8f6dbe0f-5e97-4d01-8d75-794620672622" data-linktype="relative-path">GenerateClusterLog</a>
method specified in section 3.12.4.1.</p><p><b>Return Values: </b>Return values are the same as
the return values for the GenerateClusterLog method specified in section
3.12.4.1.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>0x00000000</p>
  <p>S_OK</p>
  </td>
  <td>
  <p>The call was successful.</p>
  </td>
 </tr></tbody></table>
</dd>
<dd>
<p>For any other condition, this method MUST return a
value that is not one of the values listed in the preceding table. The client
MUST behave in a consistent, identical manner for all values that are not
listed in the preceding table.</p>
</dd></dl><p>Exceptions Thrown: No exceptions are thrown beyond those
thrown by the underlying <a href="b30bcd1c-8ff6-46d2-a27e-61bd85ace9f4#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a>
protocol <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p><p>The <a href="b30bcd1c-8ff6-46d2-a27e-61bd85ace9f4#gt_e127848e-c66d-427d-b3aa-9f904fa4ada7" data-linktype="relative-path">opnum</a>
field value for this method is 4.</p><p>When processing this call, the server MUST do the following:</p><ul><li><p><span><span> 
</span></span>Generate the file with the correct data, honoring the <i>SpanMinutes</i>
parameter.</p>
</li><li><p><span><span> 
</span></span>Place the file in a valid <i>LogFilePath</i> on the machine, as
specified in section 3.12.4.1.</p>
</li><li><p><span><span> 
</span></span>Generate the server-relative path to the file.</p>
</li></ul><p>Return the following information to the client:</p><ul><li><p><span><span> 
</span></span>The server-relative path to the file.</p>
</li></ul></div>