Platform SDK: Network Management

share_info_50

Windows 95/98: The share_info_50 structure contains information about the shared resource, including the name and type of the resource, a comment associated with the resource, and passwords.

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

struct _share_info_50 {
  char            shi50_netname[LM20_NNLEN+1];
  unsigned char   shi50_type;
  unsigned short  shi50_flags;
  char FAR *      shi50_remark;
  char FAR *      shi50_path;
  char            shi50_rw_password[SHPWLEN+1];
  char            shi50_ro_password[SHPWLEN+1];
};

Members

shi50_netname
Specifies a string containing the share name of the resource.
shi50_type
Specifies the type of resource share. This member can be one of the following predefined values.
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.

shi50_flags
Specifies an unsigned SHORT integer describing the resource, when the server is running with share-level security. This member can be one or more of the following values.
Value Meaning
SHI50F_RDONLY The share can be opened with read-only access.
SHI50F_FULL The share can be opened with read/write access.
SHI50F_ACCESSMASK The share can be opened with read/write access.
SHI50F_PERSIST The share is restored at system startup.
SHI50F_SYSTEM The share is a hidden share, and normally is not visible.

In a user-level security environment, specify the value SHI50F_FULL. When the server is running with user-level security the network management access functions (those that begin with NetAccess) determine the access rights.

shi50_remark
Pointer to a string containing an optional comment about the shared resource.
shi50_path
Pointer to a string specifying the local path for the shared resource.
shi50_rw_password
Specifies a string containing the password (when the server is running with share-level security) required to read data from and write data to the resource, and to execute the resource. If the server is running with user-level security, this member is ignored.
shi50_ro_password
Specifies a string containing the password (when the server is running with share-level security) required to read data from the resource and, by default, to execute the resource. If the server is running with user-level security, this member is ignored.

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, NetShareEnum, NetShareGetInfo, NetShareSetInfo, share_info_0, share_info_1, share_info_2