USE_INFO_1 structure (lmuse.h)
The USE_INFO_1 structure contains information about the connection between a local device and a shared resource. The information includes connection status and connection type.
Syntax
typedef struct _USE_INFO_1 {
LMSTR ui1_local;
LMSTR ui1_remote;
LMSTR 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
Type: LMSTR
A pointer to a 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. This member can be NULL. For more information, see the following Remarks section.
This string is Unicode if _WIN32_WINNT or FORCE_UNICODE are defined.
ui1_remote
Type: LMSTR
A pointer to a string that contains the share name of the remote resource being accessed. The string is in the form:
\\servername\sharename
This string is Unicode if _WIN32_WINNT or FORCE_UNICODE are defined.
ui1_password
Type: LMSTR
A pointer to a string that contains the password needed to establish a session between a specific workstation and a server.
This string is Unicode if _WIN32_WINNT or FORCE_UNICODE are defined.
ui1_status
Type: DWORD
The status of the connection. This element is not used by the NetUseAdd function. The following values are defined.
ui1_asg_type
Type: DWORD
The type of remote resource being accessed. This member can be one of the following values.
| Value | Meaning |
|---|---|
|
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 NULL. For more information, see the following Remarks section. |
|
Disk device. |
|
Spooled printer. |
|
Interprocess communication (IPC). |
ui1_refcount
Type: DWORD
The number of files, directories, and other processes that are open on the remote resource. This element is not used by the NetUseAdd function.
ui1_usecount
Type: DWORD
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.
Remarks
Specifying a ui1_local member that is NULL requests authentication with the server without redirecting a drive letter or a device. Future redirections involving the server while the same connection is in effect use the password specified by the ui1_password member in the initial call to the NetUseAdd function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | lmuse.h (include Lm.h) |