Edit

USE_INFO_2 structure (lmuse.h)

  • Article

The USE_INFO_2 structure contains information about a connection between a local computer and a shared resource, including connection type, connection status, user name, and domain name.

Syntax

typedef struct _USE_INFO_2 {
  LMSTR ui2_local;
  LMSTR ui2_remote;
  LMSTR ui2_password;
  DWORD ui2_status;
  DWORD ui2_asg_type;
  DWORD ui2_refcount;
  DWORD ui2_usecount;
  LMSTR ui2_username;
  LMSTR ui2_domainname;
} USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;

Members

ui2_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.

ui2_remote

Type: LMSTR

A pointer to a string that contains the share name of the remote resource. The string is in the form

\\servername\sharename

This string is Unicode if _WIN32_WINNT or FORCE_UNICODE are defined.

ui2_password

Type: LMSTR

A pointer to a string that contains the password needed to establish a session with a specific workstation.

This string is Unicode if _WIN32_WINNT or FORCE_UNICODE are defined.

ui2_status

Type: DWORD

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
 Disconnected.
USE_DISCONN
 An error occurred.
USE_NETERR
 A network error occurred.
USE_CONN
 The connection is being made.
USE_RECONN
 Reconnecting.

ui2_asg_type

Type: DWORD

The type of remote resource being accessed. This member can be one 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. For more information, see the following Remarks section.
USE_DISKDEV
 Disk device.
USE_SPOOLDEV
 Spooled printer.
USE_IPC
 Interprocess communication (IPC).

ui2_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.

ui2_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.

ui2_username

Type: LPWSTR

A pointer to a string that contains the name of the user who initiated the connection.

This string is Unicode if _WIN32_WINNT or FORCE_UNICODE are defined.

ui2_domainname

Type: LMSTR

A pointer to a string that contains the domain name of the remote resource.

This string is Unicode if _WIN32_WINNT or FORCE_UNICODE are defined.

Remarks

Specifying a ui2_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 authentication information specified in the initial call to the NetUseAdd function. This information includes the combination of the ui2_password, ui2_username, and ui2_domainname members.

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)

See also

NetUseAdd

NetUseEnum

NetUseGetInfo

Network Management Overview

Network Management Structures

Use Functions