The SHARE_INFO_502 structure contains information about the shared resource, including name of the resource, type and permissions, and number of connections.
typedef struct _SHARE_INFO_502 {
LPTSTR shi502_netname;
DWORD shi502_type;
LPTSTR shi502_remark;
DWORD shi502_permissions;
DWORD shi502_max_uses;
DWORD shi502_current_uses;
LPTSTR shi502_path;
LPTSTR shi502_passwd;
DWORD shi502_reserved;
PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;
Members
shi502_netname
A Unicode string containing the sharename of a resource.
shi502_type
One of the following four values specifying the type of share:
| Value | Meaning |
| STYPE_DISKTREE | Disk Drive |
| STYPE_PRINTQ | Print Queue |
| STYPE_DEVICE | Communication device |
| STYPE_IPC | Interprocess Communication (IPC) |
shi502_remark
Points to a Unicode string containing an optional comment about the shared resource.
shi502_permissions
Specifies 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
Indicates the maximum number of concurrent connections that the shared resource can accommodate (unlimited if the value specified in shi502_max_uses is -1).
shi502_current_uses
Specifies the number of current connections to the resource.
shi502_path
Points 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
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
Must be zero.
shi502_security_descriptor
Specifies the Windows NT security descriptor associated with this share.
See Also