Export (0) Print
Expand All

SHARE_INFO_503 structure

Contains information about the shared resource. It is identical to the SHARE_INFO_502 structure, except that it also contains the server name.

Syntax


typedef struct _SHARE_INFO_503 {
  LPWSTR               shi503_netname;
  DWORD                shi503_type;
  LPWSTR               shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LPWSTR               shi503_path;
  LPWSTR               shi503_passwd;
  LPWSTR               shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

Members

shi503_netname

A pointer to a Unicode string specifying the name of a shared resource. Calls to the NetShareSetInfo function ignore this member.

shi503_type

A combination of values that specify the type of share. Calls to the NetShareSetInfo function ignore this member.

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

ValueMeaning
STYPE_DISKTREE
0x00000000

Disk drive.

STYPE_PRINTQ
0x00000001

Print queue.

STYPE_DEVICE
0x00000002

Communication device.

STYPE_IPC
0x00000003

Interprocess communication (IPC).

 

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

ValueMeaning
STYPE_SPECIAL
0x80000000

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 share functions.

STYPE_TEMPORARY
0x40000000

A temporary share.

 

shi503_remark

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

shi503_permissions

Specifies a DWORD value that indicates the shared resource's permissions for servers running with share-level security. Note that Windows does not support share-level security. This member is ignored on a server running user-level security. For more information about controlling access to securable objects, see Access Control, Privileges, and Securable Objects.

Calls to the NetShareSetInfo function ignore this member.

This member can be any of the following values.

ValueMeaning
ACCESS_READ
0x00000001

Permission to read data from a resource and, by default, to execute the resource.

ACCESS_WRITE
0x00000002

Permission to write data to the resource.

ACCESS_CREATE
0x00000004

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
0x00000008

Permission to execute the resource.

ACCESS_DELETE
0x00000010

Permission to delete the resource.

ACCESS_ATRIB
0x00000020

Permission to modify the resource's attributes (such as the date and time when a file was last modified).

ACCESS_PERM
0x00000040

Permission to modify the permissions (read, write, create, execute, and delete) assigned to a resource for a user or application.

ACCESS_ALL
0x00008000

Permission to read, write, create, execute, and delete resources, and to modify their attributes and permissions.

 

shi503_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 this member is –1.

shi503_current_uses

Specifies a DWORD value that indicates the number of current connections to the resource. Calls to the NetShareSetInfo function ignore this member.

shi503_path

A pointer to a Unicode string that contains the local path for the shared resource. For disks, this member is the path being shared. For print queues, this member is the name of the print queue being shared. Calls to the NetShareSetInfo function ignore this member.

shi503_passwd

A 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, this member is ignored. Note that Windows does not support share-level security.

This member can be no longer than SHPWLEN+1 bytes (including a terminating null character). Calls to the NetShareSetInfo function ignore this member.

shi503_servername

A pointer to a string that specifies the DNS or NetBIOS name of the remote server on which the shared resource resides. A value of "*" indicates no configured server name.

shi503_reserved

Reserved; must be zero. Calls to the NetShareSetInfo function ignore this member.

shi503_security_descriptor

Specifies the SECURITY_DESCRIPTOR associated with this share.

Remarks

The remote server specified in the shi503_servername member must have been bound to a transport protocol using the NetServerTransportAddEx function. In the call to NetServerTransportAddEx, either 2 or 3 must have been specified for the level parameter, and the SVTI2_SCOPED_NAME value must have been specified in the SERVER_TRANSPORT_INFO_2 structure for the transport protocol.

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
NetServerTransportAddEx
NetSessionDel
NetShareAdd
NetShareDelEx
NetShareEnum
NetShareGetInfo
NetShareSetInfo

 

 

Community Additions

ADD
Show:
© 2014 Microsoft