Export (0) Print
Expand All
Expand Minimize

USE_INFO_1 structure

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.

ValueMeaning
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

The connection is being made.

USE_RECONN

Reconnecting.

 

ui1_asg_type

Type: DWORD

The type of remote resource being accessed. This member can be one of the following values.

ValueMeaning
USE_WILDCARD

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.

USE_DISKDEV

Disk device.

USE_SPOOLDEV

Spooled printer.

USE_IPC

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

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

Network Management Overview
Network Management Structures
Use Functions
NetUseAdd
NetUseEnum
NetUseGetInfo

 

 

Community Additions

ADD
Show:
© 2014 Microsoft