<div class="content"><p>The R_WinsStatus method retrieves configuration settings and
statistics from a <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_bafb050b-b593-4517-8093-f721bd2378ac" data-linktype="relative-path">WINS</a>
server.</p><dl>
<dd>
<div><pre> DWORD R_WinsStatus(
   [in] handle_t ServerHdl,
   [in] WINSINTF_CMD_E Cmd_e,
   [in, out, ref] PWINSINTF_RESULTS_T pResults
 );
</pre></div>
</dd></dl><p><b>ServerHdl: </b>An <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a> binding over IP
address/HostName to the WINS server. RPC uses this binding internally to
determine which WINS server the call is directed to.</p><p><b>Cmd_e: </b>The command to be executed on the <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_cb0d3fc4-7e24-49af-82c4-91a35bca857f" data-linktype="relative-path">target WINS server</a> from the
<a href="53011990-bbf6-417a-83b2-0fd4fdfe09dc" data-linktype="relative-path">WINSINTF_CMD_E</a>
enumeration (section 2.2.1.5).</p><p><b>pResults: </b>A pointer to a <a href="88f3968f-9516-41a4-80b4-7c0e7afb0676" data-linktype="relative-path">WINSINTF_RESULTS_T</a>
structure (section 2.2.2.7) that contains configuration data and statistics for
the target WINS server.</p><p><b>Return Values: </b>A 32-bit unsigned integer value
that indicates return status. A return value of ERROR_SUCCESS (0x00000000)
indicates that the operation completed successfully. Otherwise, this return
value is a Win32 error code, as specified in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>.
The following Win32 error codes can be returned.</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>ERROR_SUCCESS</p>
  </td>
  <td>
  <p>The call was successful.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000FA0</p>
  <p>ERROR_WINS_INTERNAL</p>
  </td>
  <td>
  <p>An error occurred while processing the RPC call.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000005</p>
  <p>ERROR_ACCESS_DENIED</p>
  </td>
  <td>
  <p>The caller doesn&#39;t have sufficient permissions.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>Exceptions Thrown:</b> No exceptions are thrown beyond
those thrown by the underlying RPC protocol <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p><p><b>Processing and Response Requirements:</b></p><p>The following requirements and recommendations apply to the
WINS server that processes a call to R_WinStatus:</p><ul><li><p><span><span> 
</span></span>The R_WinStatus caller SHOULD have query level access.<a id="Appendix_A_Target_6"></a><a aria-label="Product behavior note 6" href="a76435fe-902a-4235-b12d-3654ac010672#Appendix_A_6" data-linktype="relative-path">&lt;6&gt;</a> If an RPC client with a lower
access level calls R_WinStatus, the server SHOULD return ERROR_ACCESS_DENIED.</p>
</li><li><p><span><span> 
</span></span>The WINS service on the target WINS server MUST be in the running
or paused state. If the service is in initializing or exiting state, the server
SHOULD return ERROR_WINS_INTERNAL.</p>
</li><li><p><span><span> 
</span></span>When R_WinStatus is called with the <b>Cmd_e</b> parameter set to
WINSINTF_E_ADDVERSMAP, the first entry of the <i>AddVersMaps</i> array SHOULD
contain the address of the <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_f2f9c250-6c9e-445f-b677-376f23f77d87" data-linktype="relative-path">WINS
server</a> for which the version number is requested. The WINSINTF_E_ADDVERSMAP
command retrieves the version number for the specified <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_fd7218ec-39b0-4372-bf4c-9ddfba81cb9e" data-linktype="relative-path">owner</a> address from the <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_57b996ea-5019-4e6e-8848-1f850bcac53d" data-linktype="relative-path">owner version map</a> of the
target WINS server. The retrieved version number is stored in the <i>AddVersMaps[0].VersNo</i>
parameter. If the address of the <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_5adb42e6-46b8-4a71-b98c-f997bf00db61" data-linktype="relative-path">owner WINS server</a> is not
found in the owner-version map of the target WINS server, an
ERROR_WINS_INTERNAL error is returned.</p>
</li><li><p><span><span> 
</span></span>When R_WinStatus is called with the <i>Cmd_e</i> parameter set to
WINSINTF_E_CONFIG, the <i>pResults</i> parameter is used only for output. The <i>NoOfOwners</i>
and <i>AddVersMaps</i> parameters specify the owner version map table
maintained on the target WINS server. If the owner version map table has more
than 25 entries, only the first 25 entries are copied to <i>pResults-&gt;AddVersMaps</i>.
The <i>RefreshInterval</i>, <i>TombstoneInterval</i>, <i>TombstoneTimeout</i>, <i>VerifyInterval</i>,
<i>WINSPriorityClass</i>, and <i>NoOfWorkerThds</i> members get values
according to the configuration of the target WINS server. The <i>WINSStat</i>
parameter is not used for this command. An ERROR_WINS_INTERNAL error is
returned if any error occurs during processing of a WINSINTF_E_CONFIG command.</p>
</li><li><p><span><span> 
</span></span>When R_WinStatus is called with the <b>Cmd_e</b> parameter set to
WINSINTF_E_CONFIG_ALL_MAPS, the behavior is the same as specified for the
WINSINTF_E_CONFIG command except that the owner version map entry is returned
even if it is marked as deleted.</p>
</li><li><p><span><span> 
</span></span>When R_WinStatus is called with the <b>Cmd_e</b> parameter set to
WINSINTF_E_STAT, the <i>pResults</i> parameter is used only for output.
Statistics for the target WINS server are copied to <i>pResults-&gt;WINSStat</i>.
The <i>pResults-&gt;WINSStat.pRplPnrs</i> pointer MUST be NULL for this
operation to succeed. The WINSINTF_E_STAT command also retrieves the
information retrieved by the WINSINTF_E_CONFIG command. An ERROR_WINS_INTERNAL
error is returned if any error occurs during processing of a WINSINTF_E_STAT command.</p>
</li></ul></div>