2.2.5.22 USE_INFO_1

The USE_INFO_1 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.

 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;

ui1_local: A pointer to a string that contains the device name (for example, drive E or LPT1) being redirected to the shared resource.

ui1_remote: A pointer to a string that contains the share name of the remote resource being accessed. The string MUST be in the following form: "\\servername\sharename".

ui1_password: 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.

ui1_status: The current status of the connection, which MUST contain one of the following values:

Value/code

Meaning

USE_OK

0x00000000

The connection is valid.

USE_PAUSED

0x00000001

Paused by local workstation.

USE_SESSLOST

0x00000002

Disconnected.

USE_NETERR

0x00000003

A network error occurred.

USE_CONN

0x00000004

The connection is being made.

USE_RECONN

0x00000005

Reconnecting.

ui1_asg_type: The type of remote resource being accessed, which MUST contain one of the following values:

Value/code

Meaning

USE_WILDCARD

0xFFFFFFFF

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.

USE_DISKDEV

0x00000000

Disk device.

USE_SPOOLDEV

0x00000001

Spooled printer.

USE_CHARDEV

0x00000002

Serial device.

USE_IPC

0x00000003

Inter process communication (IPC).

ui1_refcount: The number of files, directories, and other processes that can be opened on the remote resource.

ui1_usecount: The number of explicit connections (with a device name) or implicit UNC connections (without the device name) that are established with the resource.