FilterGetDosName 函数 (fltuser.h)

项目
02/26/2024

FilterGetDosName 函数返回与给定卷名称对应的 MS-DOS 设备名称。

语法

HRESULT FilterGetDosName(
  [in]  LPCWSTR lpVolumeName,
  [out] LPWSTR  lpDosName,
  [in]  DWORD   dwDosNameBufferSize
);

参数

[in] lpVolumeName

指向包含卷名称的以 NULL 结尾的宽字符字符串的指针。

lpVolumeName 输入字符串可以是以下任一项。尾随反斜杠 (\) 是可选的。

驱动器号，例如“D：\”
卷装入点的路径，例如“c：\mnt\edrive\”
唯一卷标识符 (也称为 卷 GUID 名称) ，例如“\？？\Volume{7603f260-142a-11d4-ac67-806d6172696f}\”
非持久性设备名称 (也称为 目标名称 或 NT 设备名称) ，例如“\Device\HarddiskVolume1\”

此参数是必需的，不能为 NULL。

[out] lpDosName

指向调用方分配的缓冲区的指针，该缓冲区以 NULL 结尾的宽字符字符串的形式接收 MS-DOS 设备名称。

[in] dwDosNameBufferSize

lpDosName 指向的缓冲区的大小（以宽字符为单位）。

返回值

如果成功，FilterGetDosName 将返回S_OK。否则，它将返回错误值。

注解

FilterGetDosName 返回卷的驱动器号（如果有）。如果未为卷分配驱动器号， FilterGetDosName 将返回卷装入点的路径 (也称为 装载点名称) 。如果未为卷定义驱动器号或装入点， FilterGetDosName 将返回 S_OK，lpDosName 接收 NULL。