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