CONNECTION_INFO_1 structure (lmshare.h)

Contains the identification number of a connection, number of open files, connection time, number of users on the connection, and the type of connection.

Syntax

typedef struct _CONNECTION_INFO_1 {
  DWORD coni1_id;
  DWORD coni1_type;
  DWORD coni1_num_opens;
  DWORD coni1_num_users;
  DWORD coni1_time;
  LMSTR coni1_username;
  LMSTR coni1_netname;
} CONNECTION_INFO_1, *PCONNECTION_INFO_1, *LPCONNECTION_INFO_1;

Members

coni1_id

Specifies a connection identification number.

coni1_type

A combination of values that specify the type of connection made from the local device name to the shared resource.

One of the following values may be specified. You can isolate these values by using the STYPE_MASK value.

Value Meaning
STYPE_DISKTREE
Disk drive.
STYPE_PRINTQ
Print queue.
STYPE_DEVICE
Communication device.
STYPE_IPC
Interprocess communication (IPC).
 

In addition, one or both of the following values may be specified.

Value Meaning
STYPE_SPECIAL
Special share reserved for interprocess communication (IPC$) or remote administration of the server (ADMIN$). Can also refer to administrative shares such as C$, D$, E$, and so forth. For more information, see Network Share Functions.
STYPE_TEMPORARY
A temporary share.

coni1_num_opens

Specifies the number of files currently open as a result of the connection.

coni1_num_users

Specifies the number of users on the connection.

coni1_time

Specifies the number of seconds that the connection has been established.

coni1_username

Pointer to a string. If the server sharing the resource is running with user-level security, the coni1_username member describes which user made the connection. If the server is running with share-level security, coni1_username describes which computer (computername) made the connection. Note that Windows does not support share-level security.

This string is Unicode if _WIN32_WINNT or FORCE_UNICODE are defined.

coni1_netname

Pointer to a string that specifies either the share name of the server's shared resource or the computername of the client. The value of this member depends on which name was specified as the qualifier parameter to the NetConnectionEnum function. The name not specified in the qualifier parameter to NetConnectionEnum is automatically supplied to coni1_netname.

This string is Unicode if _WIN32_WINNT or FORCE_UNICODE are defined.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header lmshare.h (include Lm.h)

See also

NetConnectionEnum

Network Management Overview

Network Management Structures

Network Share Functions