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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmuse.h.

See Also

Networking (Net) Overview, Net Structures, NetUseAdd, NetUserEnum, NetUseGetInfo