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] [Next]