The USE_INFO_2 structure contains usability information about a remote or shared resource and their associated accounts.
typedef struct _USE_INFO_2 {
LPTSTR ui2_local;
LPTSTR ui2_remote;
LPTSTR ui2_password;
DWORD ui2_status;
DWORD ui2_asg_type;
DWORD ui2_refcount;
DWORD ui2_usecount;
LPTSTR ui2_username;
LPTSTR ui2_domainname;
}USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;
Members
ui2_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.
ui2_remote
Points to a Unicode string that specifies the share name of the remote resource. The string is in the form
\\servername\sharename
ui2_password
Points to a Unicode string that contains the password needed to establish a session with a specific workstation.
ui2_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 successful. |
USE_PAUSED | Paused by a local workstation. |
USE_SESSLOST | The connection is connected. |
USE_DISCONN | An error occurred. |
USE_NETERR | A network error occurred. |
USE_CONN | The connection is being made. |
SE_RECONN | Reconnecting. |
ui2_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 ui2_local member is a null string. |
USE_DISKDEV | Disk device. |
USE_SPOOLDEV | Spooled printer. |
USE_CHARDEV | Communication device. |
USE_IPC | Interprocess communication (IPC). |
ui2_refcount
Specifies the number of files, directories, and other processes that are open on the remote resource. This element is not used by the NetUseAdd function.
ui2_usecount
Specifies the number of explicit connections (redirection with a local device name) or implicit UNC connections (redirection without a local device name) that are established with the resource.
ui2_username
Specifies the name of user in the domain.
ui2_domainname
Specifies the domain of the resource.
See Also