<div class="content" name="GenerateClusterHealthLog" uuid="061c4ece-6e1e-4c0f-9b30-ff66d60e94bf"><p>The <b>GenerateClusterHealthLog</b> method<a id="Appendix_A_Target_46"></a><a aria-label="Product behavior note 46" href="6ea29e14-9c33-4927-90a8-258fd1d6d042#Appendix_A_46" data-linktype="relative-path">&lt;46&gt;</a> generates the health log file
on cluster nodes. The content and format of the file is implementation-specific
but SHOULD contain diagnostic information.</p><dl>
<dd>
<div><pre> HRESULT GenerateClusterHealthLog {
   [ in ] unsigned long SpanMinutes,
   [ in ] ClusterLogExFlag flags,
   [ 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> – SpanMinutes) MUST be in the log and no
others. If ClusterLogFlagLocalTime is set in the Flags field, <b>Now</b> is the
GMT on the server; otherwise, it is the local time on the server.</p><p><b>Flags:</b> Is the type <b>ClusterLogExFlag</b>
enum as specified in section <span><a href="e2b0f313-a6b9-4fd5-b5fc-7f584e3a0a84" data-linktype="relative-path">2.2.25</a></span>.</p><p><b>LogFilePath:</b> Has the same meaning as parameter
<i>LogFilePath</i> for the <b>GenerateClusterLog</b> method specified in
section <span><a href="8f6dbe0f-5e97-4d01-8d75-794620672622" data-linktype="relative-path">3.12.4.1</a></span>.</p><p><b>Return Values: </b>Return values are the same as
the return values for the <b>GenerateClusterLog</b> 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>0x00000000 S_OK</td>
  <td>The call was successful.</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 an identical manner for all return values not listed in the
preceding table.</p>
</dd></dl><p>Exceptions Thrown: No exceptions are thrown beyond those
thrown by the underlying RPC protocol <span><a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a></span>.</p><p>The opnum 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>If ClusterLogFlagLocalTime is set in the Flags field, use local
time on the server.</p>
</li><li><p><span><span> 
</span></span>Generate the health log 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 <span><a href="2f8a5df5-5c19-4d63-b014-5a6cb37e0a19" data-linktype="relative-path">3.18.4.1</a></span>.</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>