Share Level 2

 
struct share_info_2 {
  unsigned char                 shi2_netname[NNLEN+1];
  unsigned char                 shi2_pad1;
  unsigned short                shi2_type;
  unsigned char LSFAR * LSPTR   shi2_remark;
  unsigned short                shi2_permissions;
  unsigned short                shi2_max_uses;
  unsigned short                shi2_current_uses;
  unsigned char LSFAR * LSPTR   shi2_path;
  unsigned char                 shi2_passwd[SHPWLEN+1];
  unsigned char                 shi2_pad2;
};

where:

• The first two fields in this data structure are identical to those in the previous level.

• shi2_type is one of four values indicating the type of share, as defined in the SHARES.H header file: ┌────────────────────┬───────┬─────────────────────────────────────────────────┐
  │ SYMBOLIC CONSTANT │ VALUE │ MEANING │
  ├────────────────────┼───────┼─────────────────────────────────────────────────┤
  │ STYPE_DISKTREE │ 0 │ Disk drive │
  ├────────────────────┼───────┼─────────────────────────────────────────────────┤
  │ STYPE_PRINTQ │ 1 │ Spooler queue │
  ├────────────────────┼───────┼─────────────────────────────────────────────────┤
  │ STYPE_DEVICE │ 2 │ Serial device │
  ├────────────────────┼───────┼─────────────────────────────────────────────────┤
  │ STYPE_IPC │ 3 │ Interprocess communication (IPC) │
  └────────────────────┴───────┴─────────────────────────────────────────────────┘
  

  Note: The shi2_type value affects the requirements for certain other share_info_2 components when the NetShareAdd function is called. See "Remarks" in topic Share - NetShareAdd for details.

  
  The next field is identical to the same field in the previous level.
  
  shi2_permissions is used only for DLS applications and ignored for OS/2 applications. The meaning of this field depends on which type of resource is in query (specified by the shi1_type field).

  • If shi1_type is STYPE_DISKTREE, this field can be any combination of the following permissions, except for ACCESS_READ + ACCESS_CREATE. These are defined for use with DLS applications in the ACCESS.H header file as follows: ┌───────────────────┬───────┬──────────────────────────────────────────────────┐
    │ SYMBOLIC CONSTANT │ VALUE │ MEANING │
    ├───────────────────┼───────┼──────────────────────────────────────────────────┤
    │ ACCESS_READ │ 0x01 │ Permission to read data from a resource. │
    ├───────────────────┼───────┼──────────────────────────────────────────────────┤
    │ ACCESS_WRITE │ 0x02 │ Permission to write data to a resource. │
    ├───────────────────┼───────┼──────────────────────────────────────────────────┤
    │ ACCESS_CREATE │ 0x04 │ Permission to create an instance of the resource │
    │ │ │ (such as a file). Data can be written to the │
    │ │ │ resource as the resource is created. │
    └───────────────────┴───────┴──────────────────────────────────────────────────┘
    

  • If shi1_type is STYPE_PRINTQ, the shi2_permissions field specifies the form control at the end of a print job. These are defined for use with DLS applications in the DOSPRINT.H header file as follows: ┌───────────────────┬───────┬──────────────────────────────────────────────────┐
    │ SYMBOLIC CONSTANT │ BIT │ MEANING │
    │ │ VALUE │ │
    ├───────────────────┼───────┼──────────────────────────────────────────────────┤
    │ FORMFEED_NO │ 1 │ The printer will not be sent a command at the │
    │ │ │ end of any print job to position to the top of │
    │ │ │ the page. │
    ├───────────────────┼───────┼──────────────────────────────────────────────────┤
    │ FORMFEED_AUTO │ 2 │ An attempt is made to determine whether a form │
    │ │ │ feed is needed for a print job. If the last 64 │
    │ │ │ bytes of the file contain no form feed command │
    │ │ │ or follow a form feed command with printable │
    │ │ │ characters, a form feed command is issued to the │
    │ │ │ printer. │
    ├───────────────────┼───────┼──────────────────────────────────────────────────┤
    │ FORMFEED_YES │ 5 │ A form feed command is issued to the printer at │
    │ │ │ the end of each print job to position to the top │
    │ │ │ of the next form (default). │
    └───────────────────┴───────┴──────────────────────────────────────────────────┘
    

    Note: DLS does not support sharing of serial devices (STYPE_DEVICE). In some circumstances, however, COM devices, such as COM1, can be shared as print devices (STYPE_PRINTQ); for example, if operating in synchronous communication mode, such as with a serial printer.

    
    shi2_max_uses gives the maximum number of concurrent connections the shared resource can accommodate. This number is unlimited if the shi2_max_uses value is -1. (This field is ignored for DLS.)
    
    shi2_current_uses indicates the number of connections currently made to the resource. (This field is ignored for DLS.)
    
    shi2_path points to an ASCIIZ string containing the local path name of the shared resource. For disks, shi2_path is the path being shared. For spooler queues, shi2_path is the name of the spooler queue being shared. For serial device queues, shi2_path is a string of one or more communication device names separated by spaces; for example, COM1 COM2 COM6. The maximum length of the string is 254 bytes.
    
    shi2_passwd is a reserved field and must be NULL.
    
    shi2_pad2 word-aligns the data structure component.

    ---

    [Back: Share Level 1]
    [Next: Related Information]