share_info_2

Windows 95/98: The share_info_2 structure contains information about the shared resource, including the name and type of the resource, permissions, password, and current connections.

Windows NT/2000: This structure is not supported on Windows NT/Windows 2000.

struct _share_info_2 {
  char            shi2_netname[LM20_NNLEN+1];
  char            shi2_pad1;
  unsigned short  shi2_type;
  char FAR *      shi2_remark;
  unsigned short  shi2_permissions;
  unsigned short  shi2_max_uses;
  unsigned short  shi2_current_uses;
  char FAR *      shi2_path;
  char            shi2_passwd[SHPWLEN+1];
  char            shi2_pad2;
};

Members

shi2_netname

Specifies a string containing the share name of the resource.

shi2_pad1

Specifies padding inserted to align the next member.

shi2_type

Specifies an unsigned SHORT integer that indicates the type of the shared resource.

Value	Meaning
STYPE_DISKTREE	Disk drive
STYPE_PRINTQ	Print queue
STYPE_DEVICE	Communication device
STYPE_IPC	Interprocess communication (IPC)
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 the network management share functions.

shi2_remark

Pointer to a string containing an optional comment about the shared resource.

shi2_permissions

Specifies an unsigned SHORT integer that indicates the shared resource's permissions for servers running with share-level security. This member can be one or more of the following values.

Value	Meaning
ACCESS_READ	Permission to read data from a resource and, by default, to execute the resource.
ACCESS_WRITE	Permission to write data to the resource.
ACCESS_CREATE	Permission to create an instance of the resource (such as a file); data can be written to the resource as the resource is created.
ACCESS_EXEC	Permission to execute the resource.
ACCESS_DELETE	Permission to delete the resource.
ACCESS_ATRIB	Permission to modify the resource's attributes (such as the date and time when a file was last modified).
ACCESS_PERM	Permission to modify the permissions (read, write, create, execute, and delete) assigned to a resource for a user or application.
ACCESS_ALL	Permission to read, write, create, execute, and delete resources, and to modify their attributes and permissions.

shi2_max_uses

Specifies an unsigned SHORT integer that indicates the maximum number of concurrent connections the shared resource can accommodate.

shi2_current_uses

Specifies an unsigned SHORT integer that indicates the current number of connections to the shared resource.

shi2_path

Pointer to a string specifying the local path for the shared resource.

shi2_passwd

Specifies a string indicating the share's password when the server is running with share-level security. If the server is running with user-level security, this member is ignored.

shi2_pad2

Specifies padding inserted to align the next structure.

Requirements

  Windows NT/2000: Unsupported.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Svrapi.h.

See Also

Network Management Overview, Network Management Structures, Share Functions, NetShareGetInfo, share_info_0, share_info_1, share_info_50