SHARE_INFO_502

The SHARE_INFO_502 structure contains information about the shared resource, including name of the resource, type and permissions, number of connections, and other pertinent information.

typedef struct _SHARE_INFO_502 {
  LPWSTR    shi502_netname;
  DWORD     shi502_type;
  LPWSTR    shi502_remark;
  DWORD     shi502_permissions;
  DWORD     shi502_max_uses;
  DWORD     shi502_current_uses;
  LPWSTR    shi502_path;
  LPWSTR    shi502_passwd;
  DWORD     shi502_reserved;
  PSECURITY_DESCRIPTOR  shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

Members

shi502_netname

Pointer to a Unicode string specifying the name of a shared resource.

shi502_type

Specifies a DWORD value that indicates the type of share.

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.

shi502_remark

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

shi502_permissions

Specifies a DWORD value that indicates the shared resource's permissions for servers running with share-level security. This member is ignored on a server running user-level security. This member can be any 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.

shi502_max_uses

Specifies a DWORD value that indicates the maximum number of concurrent connections that the shared resource can accommodate. The number of connections is unlimited if the value specified in shi502_max_uses is –1.

shi502_current_uses

Specifies a DWORD value that indicates the number of current connections to the resource.

shi502_path

Pointer to a Unicode string that contains the local path for the shared resource. For disks, shi502_path is the path being shared. For print queues, shi502_path is the name of the print queue being shared.

shi502_passwd

Pointer to a Unicode string that specifies the share's password (when the server is running with share-level security). If the server is running with user-level security, shi502_passwd is ignored. The shi502_passwd member can be no longer than SHPWLEN+1 bytes (including a terminating null character).

shi502_reserved

Reserved; must be zero.

shi502_security_descriptor

Specifies the security descriptor associated with this share.

Requirements

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

See Also

Network Management Overview, Network Management Structures, Share Functions, NetShareAdd, NetShareEnum, NetShareGetInfo, NetShareSetInfo