CONNECTION_INFO_1 structure

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.

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

ValueMeaning
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

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

Network Management Overview
Network Management Structures
Network Share Functions
NetConnectionEnum

 

 

Community Additions

ADD
Show:
© 2014 Microsoft