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

NetUseAdd, NetUserEnum, NetUseGetInfo