USE_INFO_1  5PF59V 

The USE_INFO_1 structure contains status information about a remote or shared resource and their associated accounts.

typedef struct _USE_INFO_1 { 
    LPTSTR  ui1_local;
    LPTSTR  ui1_remote;
    LPTSTR  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

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.

ui1_remote

Points to a Unicode string that specifies the share name of the remote resource. The string is in the form

\e\eservername\e\esharename

 

ui1_password

Points to a Unicode string that contains the password needed to establish a session with a specific workstation.

ui1_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 valid.

USE_PAUSED

Paused by local workstation.

USE_SESSLOST

Disconnected.

USE_DISCONN

An error occurred.

USE_NETERR

A network error occurred.

USE_CONN

Connection is being made.

SE_RECONN

Reconnecting.

 

ui1_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 NetUseAddKPOZMU function, and only when the ui1_local member is a null string.

USE_DISKDEV

Disk device.

USE_SPOOLDEV

Spooled printer.

USE_CHARDEV

Communication device.

USE_IPC

Interprocess communication (IPC).

 

ui1_refcount

Specifies how many files, directories, and other processes are open on the remote resource. This element is not used by the NetUseAddKPOZMU function.

ui1_usecount

Specifies how many explicit connections (redirection with a local device name) or implicit UNC connections (redirection without a local device name) are established with the resource.

 

See Also

NetUseAdd, NetUserEnum, NetUseGetInfo