USE_INFO_2
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