pszPathName (PSZ) - input

      Address of the ASCIIZ full path name of the file or subdirectory.

      Global file-name characters are not permitted.

      DosQuerySysInfo is called by an application during initialization to determine the maximum path length allowed by the operating system.

    ulInfoLevel (ULONG) - input

      The level of file directory information being defined.

      A value of 1 or 2 can be specified, as shown in the following list.

    • FIL_STANDARD Level 1 file information

    • FIL_QUERYEASIZE
      Level 2 file information

      The structures described in pInfoBuf indicate the information being set for each of these levels.

    pInfoBuf (PVOID) - input

      Address of the storage area containing the file information being set.

      Level 1 File Information (ulInfoLevel == FIL_STANDARD)

        pInfoBuf contains the FILESTATUS3 data structure.
      Level 2 File Information (ulInfoLevel == FIL_QUERYEASIZE)
        pInfoBuf contains an EAOP2 data structure.

        Level 2 sets a series of extended attribute (EA) name/value pairs.

        Input

          pInfoBuf contains an EAOP2 data structure. fpGEA2List is ignored. fpFEA2List points to a data area where the relevant FEA2 list is to be found. oError is ignored. The FEA2 data structures must be aligned on a doubleword boundary. Each oNextEntryOffset field must contain the number of bytes from the beginning of the current entry to the beginning of the next entry in the FEA2 list. The oNextEntryOffset field in the last entry of the FEA2 list must be zero.
        Output
          fpGEA2List and fpFEA2List are unchanged. The area that fpFEA2List points to is unchanged. If an error occurred during the set, oError is the offset of the FEA2 entry where the error occurred. The return code is the error code corresponding to the condition that caused the error. If no error occurred, oError is undefined.

        cbInfoBuf (ULONG) - input

          The length, in bytes, of pInfoBuf.

        flOptions (ULONG) - input

          Information on how the set operation is to be performed.

          If flOptions is 0x00000010 (DSPI_WRTTHRU), then all the information, including extended attributes (EAs), must be written to the disk before returning to the application. This guarantees that the EAs have been written to the disk. All other bits are reserved, and must be zero.

        ulrc (APIRET) - returns

          Return Code.

          DosSetPathInfo returns one of the following values:

        • NO_ERROR 2
            ERROR_FILE_NOT_FOUND
          3
            ERROR_PATH_NOT_FOUND
          32
            ERROR_SHARING_VIOLATION
          87
            ERROR_INVALID_PARAMETER
          124
            ERROR_INVALID_LEVEL
          206
            ERROR_FILENAME_EXCED_RANGE
          122
            ERROR_INSUFFICIENT_BUFFER
          254
            ERROR_INVALID_EA_NAME
          255
            ERROR_EA_LIST_INCONSISTENT
          For a full list of error codes, see Errors.

        [Back] [Next]