QueryDosDevice

【勇芳软件工作室】汉化HomePreviousNext

QueryDosDevice功能允许应用程序获取有关MS-DOS设备名称的信息。该函数可以获得特定MS-DOS设备名称的当前映射。该函数还可以获取所有现有MS-DOS设备名称的列表。

MS-DOS设备名称作为符号链接存储在Windows NT对象名称空间中。将MS-DOS路径转换为相应的Windows NT路径的代码使用这些符号链接映射MS-DOS设备和驱动器号。QueryDosDevice功能提供了一种机制,基于Win32的应用程序可以查询用于实现MS-DOS设备命名空间的符号链接的名称以及每个特定符号链接的值。

DWORD QueryDosDevice(

LPCTSTR 【lpDeviceName】,// MS-DOS设备名称字符串的地址
LPTSTR 【lpTargetPath】,//存储查询结果的缓冲区地址
DWORD 【// maximum storage capacity of buffer】//缓冲区的最大存储容量
); 

参数

【lpDeviceName】

指向指定查询目标的MS-DOS设备名称字符串的指针。

此参数可以为NULL。在这种情况下,QueryDosDevice函数将将所有现有的MS-DOS设备名称列表存储到【lpTargetPath】指向的缓冲区中。

【lpTargetPath】

指向将接收查询结果的缓冲区。该函数用一个或多个以null结尾的字符串填充此缓冲区。最后以空值终结的字符串后跟一个额外的NULL。

如果【lpDeviceName】非NULL,则该函数获取有关由【lpDeviceName】指定的特定MS-DOS设备的信息。存储在缓冲区中的第一个以null结尾的字符串是设备的当前映射。其他以null结尾的字符串表示设备的未删除的先前映射。

如果【lpDeviceName】为NULL,则该函数获取所有现有MS-DOS设备名称的列表。存储在缓冲区中的每个以null结尾的字符串都是现有MS-DOS设备的名称。

【// maximum storage capacity of buffer】

指定可以存储到【lpTargetPath】指向的缓冲区中的最大字符数。

返回值

如果函数成功,则返回值是由【lpTargetPath】指向的缓冲区中存储的字符数。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

DefineDosDevice功能提供了一种方法,使基于Win32的应用程序可以创建和修改用于实现MS-DOS设备命名空间的符号链接。

MS-DOS设备名称是全局的。一旦定义,MS-DOS设备名称对于所有进程保持可见,直到它被清除或系统重新启动。

也可以看看

DefineDosDevice