<div class="content" name="USE_INFO_1" uuid="969d330b-fffa-4c4f-8331-62b3989086ff"><p>The <b>USE_INFO_1</b> structure specifies details about the
connection between a machine on which the workstation service is running and a
shared resource, including connection status and connection type.</p><dl>
<dd>
<div><pre> typedef struct _USE_INFO_1 {
   [string] wchar_t* ui1_local;
   [string] wchar_t* ui1_remote;
   [string] wchar_t* ui1_password;
   unsigned long ui1_status;
   unsigned long ui1_asg_type;
   unsigned long ui1_refcount;
   unsigned long ui1_usecount;
 } USE_INFO_1,
  *PUSE_INFO_1,
  *LPUSE_INFO_1;
</pre></div>
</dd></dl><p><b>ui1_local:</b> A pointer to a string that contains
the device name (for example, drive E or LPT1) being redirected to the shared
resource.</p><p><b>ui1_remote:</b> A pointer to a string that
contains the share name of the remote resource being accessed. The string MUST
be in the following form: &#34;<i>\\servername\sharename&#34;</i>.</p><p><b>ui1_password:</b> A pointer to a string that
contains the password needed to establish a session between a machine on which
the workstation service is running and a server.</p><p><b>ui1_status:</b> The current status of the
connection, which MUST contain one of the following values:</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value/code</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>USE_OK 0x00000000</td>
  <td>The connection is valid.</td>
 </tr><tr>
  <td>USE_PAUSED 0x00000001</td>
  <td>Paused by local workstation.</td>
 </tr><tr>
  <td>USE_SESSLOST 0x00000002</td>
  <td>Disconnected.</td>
 </tr><tr>
  <td>USE_NETERR 0x00000003</td>
  <td>A network error occurred.</td>
 </tr><tr>
  <td>USE_CONN 0x00000004</td>
  <td>The connection is being made.</td>
 </tr><tr>
  <td>USE_RECONN 0x00000005</td>
  <td>Reconnecting.</td>
 </tr></tbody></table>
</dd></dl><p><b>ui1_asg_type:</b> The type of remote resource
being accessed, which MUST contain one of the following values:</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value/code</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>USE_WILDCARD 0xFFFFFFFF</td>
  <td>Matches the type of the server’s shared resources. Wildcards can be used only with the NetrUseAdd function (section 3.2.4.7), and only when the ui1_local member is NULL.</td>
 </tr><tr>
  <td>USE_DISKDEV 0x00000000</td>
  <td>Disk device.</td>
 </tr><tr>
  <td>USE_SPOOLDEV 0x00000001</td>
  <td>Spooled printer.</td>
 </tr><tr>
  <td>USE_CHARDEV 0x00000002</td>
  <td>Serial device.</td>
 </tr><tr>
  <td>USE_IPC 0x00000003</td>
  <td>Inter process communication (IPC).</td>
 </tr></tbody></table>
</dd></dl><p><b>ui1_refcount:</b> The number of files,
directories, and other processes that can be opened on the remote resource.</p><p><b>ui1_usecount:</b> The number of explicit
connections (with a device name) or implicit UNC connections (without the device
name) that are established with the resource.</p></div>