DosProtectSetFileInfo - Parameters

hf (HFILE) - input

File handle.

ulInfoLevel (ULONG) - input

Level of file information being set.

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 structures for file information levels.

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 EA name/value pairs. On input, pInfoBuf is an EAOP2 data structure. fpGEA2List is ignored. fpFEA2List points to a data area where the relevant is an FEA2 list is to be found. oError is ignored.

On output, fpGEA2List and fpFEA2List are unchanged. The area pointed to by fpFEA2List is unchanged. If an error occurred during the set, oError is the offset of the FEA2 where the error occurred. The return code is the error code corresponding to the condition generating the error. If no error occurred, oError is undefined.

cbInfoBuf (ULONG) - input

The length, in bytes, of pInfoBuf.

fhFileHandleLockID (FHLOCK) - input

The filehandle lockid obtained from DosProtectOpen.

ulrc (APIRET) - returns

Return Code.

DosProtectSetFileInfo returns one of the following values:

• NO_ERROR 1
  ERROR_INVALID_FUNCTION
  5
  ERROR_ACCESS_DENIED
  6
  ERROR_INVALID_HANDLE
  87
  ERROR_INVALID_PARAMETER
  122
  ERROR_INSUFFICIENT_BUFFER
  124
  ERROR_INVALID_LEVEL
  130
  ERROR_DIRECT_ACCESS_HANDLE
  254
  ERROR_INVALID_EA_NAME
  255
  ERROR_EA_LIST_INCONSISTENT
  For a full list of error codes, see Errors.

---

[Back: DosProtectSetFileInfo Return Value - ulrc]
[Next: DosProtectSetFileInfo - Remarks]