DosSetPathInfo - Parameters

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: DosSetPathInfo Return Value - ulrc]
[Next: DosSetPathInfo - Remarks]