# Function Reference

# _WinAPI_QueryDosDevice

Retrieves the current mapping for a particular MS-DOS device name

#include <WinAPIFiles.au3>
_WinAPI_QueryDosDevice ( $sDevice )

## Parameters

$sDevice | The name of the MS-DOS device.

## Return Value

Success: | The current mapping for the specified device. If the $sDevice parameter is empty string, return array of all existing MS-DOS device names (for example, "\Device\HarddiskVolume1" or "\Device\Floppy0"). The zeroth array element contains the number of names.
Failure: | Sets the @error flag to non-zero, call _WinAPI_GetLastError() to get extended error information.

## See Also

Search QueryDosDevice in MSDN Library.

## Example

    #include <WinAPIFiles.au3>

    Local $aDrive = DriveGetDrive('ALL')

    If IsArray($aDrive) Then
        For $i = 1 To $aDrive[0]
            ConsoleWrite(StringUpper($aDrive[$i]) & ' => ' & _WinAPI_QueryDosDevice($aDrive[$i]) & @CRLF)
        Next
    EndIf