DosQueryFSAttach - Parameters

pszDeviceName (PSZ) - input

A drive designation or the name of a character or pseudocharacter device.

If it is a drive designation, pszDeviceName is an ASCIIZ string consisting of a drive name followed by a colon. If it is a character or pseudocharacter device name, pszDeviceName is an ASCIIZ string consisting of a file name and the subdirectory, DEV. pszDeviceName is ignored if level 2 or 3 is specified for ulFSAInfoLevel.

ulOrdinal (ULONG) - input

An index into the list of character or pseudocharacter devices, or the set of drives.

ulOrdinal always starts at 1. The ordinal position of an item in a list has no significance. ulOrdinal is used only to step through the list. The mapping from ulOrdinal to the item is volatile, and may change from one call to DosQueryFSAttach to the next. ulOrdinal is ignored if level 1 is specified for ulFSAInfoLevel.

ulFSAInfoLevel (ULONG) - input

Level of information returned in pfsqb.

Possible levels are described in the following list:

• FSAIL_QUERYNAME Returns data for the drive or device name specified in pszDeviceName. ulOrdinal is ignored.

• FSAIL_DEVNUMBER
  Returns data for the entry in the list of character or pseudocharacter devices selected by ulOrdinal. pszDeviceName is ignored.

• FSAIL_DRVNUMBER
  Returns data for the entry in the list of drives selected by ulOrdinal. pszDeviceName is ignored.

pfsqb (PFSQBUFFER2) - output

Address of the buffer for returned information.

Note: The szName is the file-system driver name exported by the file-system driver. This name is not necessarily the same as the file-system driver name in the boot sector.

For local character devices (iType = 1), cbFSDName = 0, and szName contains only a terminating null byte; cbFSAData = 0.

For local drives (iType = 3), szName contains the name of the file-system driver attached to the drive at the time of the call. This information changes dynamically. If the drive is attached to the kernel's resident file system, szName contains FAT or an unknown name. Since the resident file system gets attached to any disk that other file-system drivers refuse to mount, it is possible to have a disk that does not contain a recognizable file system, but yet gets attached to the resident file system. In this case, it is possible to detect the difference, and this information would help programs to preserve data on a disk that was not properly recognized.

pcbBuffLength (PULONG) - in/out

Address of the length, in bytes, of the data buffer.

Input

The address of the length, in bytes, of the return buffer (pfsqb).
Output
The length, in bytes, of the data returned in pfsqb by the file-system driver.

ulrc (APIRET) - returns

Return Code.

DosQueryFSAttach returns one of the following values:

• NO_ERROR 15
  ERROR_INVALID_DRIVE
  111
  ERROR_BUFFER_OVERFLOW
  124
  ERROR_INVALID_LEVEL
  259
  ERROR_NO_MORE_ITEMS
  For a full list of error codes, see Errors.

---

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