ulRefType (ULONG) - input

A value that indicates whether pvFile points to a handle or to an ASCIIZ name.

Possible values are shown in the following list:

• ENUMEA_REFTYPE_FHANDLE
  Handle of a file.

• ENUMEA_REFTYPE_PATH
  ASCIIZ name of a file or subdirectory.

pvFile (PVOID) - input

The address of the file handle, or the file name.

If ulRefType equals ENUMEA_REFTYPE_FHANDLE, this field contains the address of the handle of a file returned by DosOpen. If ulRefType equals ENUMEA_REFTYPE_PATH, this field contains the ASCIIZ name of a file or subdirectory.

ulEntry (ULONG) - input

Ordinal of an entry in the file object's EA list, which indicates where in the list to begin the return of EA information.

The value 0 is reserved. A value of 1 indicates the file object's first EA; a value of 2, the second; and so on.

pvBuf (PVOID) - output

Address of the buffer where EA information is returned.

Level 1 information (ulInfoLevel == ENUMEA_LEVEL_NO_VALUE) is returned in a data structure of type DENA2.

cbBuf (ULONG) - input

The length, in bytes, of the buffer pointed to by pvBuf.

pulCount (PULONG) - in/out

A pointer to a ULONG containing the number of EAs.

Input

Contains the number of EAs for which information is requested. A value of -1 requests that information be returned for as many EAs whose information fits in pvBuf.
Output
Contains the actual number of EAs for which information is returned. When this value is greater than 1, enumerated information is returned in a series of DENA2 data structures. Each data structure is aligned on a doubleword boundary. The first field of the data structure (oNextEntryOffset) contains the number of bytes to the beginning of the next data structure. A value of zero for oNextEntryOffset indicates that this is the last data structure.

ulInfoLevel (ULONG) - input

Level of information required.

Only the value 1 (ENUMEA_LEVEL_NO_VALUE) can be specified, indicating return of level 1 information.

fhFileHandleLockID (FHLOCK) - input

The filehandle lockid returned from DosProtectOpen.

Required only when ulRefType is equal to zero. Otherwise, value is ignored.

ulrc (APIRET) - returns

Return Code.

DosProtectEnumAttribute returns one of the following values:

• NO_ERROR 3
  ERROR_PATH_NOT_FOUND
  5
  ERROR_ACCESS_DENIED
  6
  ERROR_INVALID_HANDLE
  8
  ERROR_NOT_ENOUGH_MEMORY
  87
  ERROR_INVALID_PARAMETER
  111
  ERROR_BUFFER_OVERFLOW
  124
  ERROR_INVALID_LEVEL
  206
  ERROR_FILENAME_EXCED_RANGE
  For a full list of error codes, see Errors.

---

[Back] [Next]