The USE_INFO_1 structure contains status information about a remote or shared resource and their associated accounts.
typedef struct _USE_INFO_1 {
LPTSTR ui1_local;
LPTSTR ui1_remote;
LPTSTR ui1_password;
DWORD ui1_status;
DWORD ui1_asg_type;
DWORD ui1_refcount;
DWORD ui1_usecount;
}USE_INFO_1, *PUSE_INFO_1, *LPUSE_INFO_1;
Members
ui1_local
Specifies a Unicode string that contains the local device name (for example, drive E or LPT1) being redirected to the shared resource. The constant DEVLEN specifies the maximum number of characters in the string.
ui1_remote
Points to a Unicode string that specifies the share name of the remote resource. The string is in the form
\e\eservername\e\esharename
ui1_password
Points to a Unicode string that contains the password needed to establish a session with a specific workstation.
ui1_status
Specifies the status of the connection. This element is not used by the NetUseAdd function. The following values are defined:
| Value | Meaning |
| USE_OK | The connection is valid. |
| USE_PAUSED | Paused by local workstation. |
| USE_SESSLOST | Disconnected. |
| USE_DISCONN | An error occurred. |
| USE_NETERR | A network error occurred. |
| USE_CONN | Connection is being made. |
| SE_RECONN | Reconnecting. |
ui1_asg_type
Contains values that determine several features. This member can be any of the following values:
| Value | Meaning |
| USE_WILDCARD | Matches the type of the server's shared resources. Wildcards can be used only with the NetUseAdd function, and only when the ui1_local member is a null string. |
| USE_DISKDEV | Disk device. |
| USE_SPOOLDEV | Spooled printer. |
| USE_CHARDEV | Communication device. |
| USE_IPC | Interprocess communication (IPC). |
ui1_refcount
Specifies how many files, directories, and other processes are open on the remote resource. This element is not used by the NetUseAdd function.
ui1_usecount
Specifies how many explicit connections (redirection with a local device name) or implicit UNC connections (redirection without a local device name) are established with the resource.
See Also