QueryDosDevice,函式。在Windows NT中,DOS設備名會映射成NT系統設備名。該函式可判斷當前的設備映射情況。
基本介紹
- 中文名:QueryDosDevice
- 外文名:QueryDosDevice
- 返回值: Long,零表示出錯
- 適用平台: Windows NT
簡介,相關函式,
簡介
VB聲明
Declare Function QueryDosDevice Lib "kernel32" Alias "QueryDosDeviceA" (ByVal lpDeviceName As String, ByVal lpTargetPath As String, ByVal ucchMax As Long) As Long
返回值
Long,零表示出錯。如執行成功,返回保存到lpTargetPath的字元數。會設定GetLastError
參數表
參數 類型及說明
lpDeviceName String,如果是vbNullString,那么lpTargetPath會載入當前映射的MS-DOS名稱的一個列表。如果是個MS-DOS名,則lpTargetPath會載入一個設備映射列表(第一個名字是活動映射,後續的名字是以前尚未刪掉的映射)
lpTargetPath String,名稱列表,具體取決於lpDeviceName參數。這些名字用NULL字元分隔。列表最後用兩個連續的NULL字元中止
ucchMax Long,lpTargetPath緩衝區的大小
註解
可用DefineDosDevice函式將映射變成DOS設備名
Windows NT
相關函式
QueryDosDevice函式是一個應用程式獲得有關DOS設備名的信息。該函式可以獲得特定DOS設備名的當前映射。該函式還可以獲得所有存在的DOS設備的列表。
DOS設備蜜柑作為符號連線被存儲在Windows NT對象名空間中。把一個DOS路徑轉換成對應的Windows NT 路徑的代碼使用這些符號連線來映射DOS設備和驅動器字母。QueryDosDevice函式提供一個機制使WIN32應用程式可以查詢用於實現DOS設備名空間的符號連線的名稱和查詢每個特定符號連線的值。
參數:lpDeviceName
指向一個DOS設備名字元串,該字元串指定查詢的目標。該參數可以為NULL。在這種情況下,QueryDosDevice函式將把所有已存在的DOS設備名列表存儲到lpTargetPath指向的快取區。
LpTargetPath
指向將接收查詢結果的快取區。該函式把一個或多個以NULL結束的字元串填充到這個快取區中。最後一個以NULL結合素的字元串後還跟有一個附加的NULL。
若lpDeviceName不是NULL,則該函式可以獲得有關由lpDeviceName指定的特定DOS設備的信息。存儲到快取區中的第一個以NULL結束的字元串是該設備的當前映射,其餘以NULL結束的字元串代表設備的未被刪除的原映射。若lpDevicceName為NULL,則該函式獲得所有已存在的DOS設備名的列表。存儲在該快取區中的每個以NULL結束的字元串是已存在的DOS設備的名稱。