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

      Address of the handle of a file returned by DosOpen; or 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

      Pointer to number of EAs.

      Input

        A pointer to the ULONG containing 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
        A pointer to the ULONG containing 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 (or 32-bit) 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.

      ulrc (APIRET) - returns

        Return Code.

        DosEnumAttribute returns one of the following values:

      • NO_ERROR 2
          ERROR_FILE_NOT_FOUND
        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]