Поделиться через

Функция FilterGetDosName (fltuser.h)

  • Статья

Функция 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

Указатель на буфер, выделенный вызывающим объектом, который получает имя устройства MS-DOS в виде строки расширенных символов с завершением NULL.

[in] dwDosNameBufferSize

Размер буфера, на который указывает lpDosName , в расширенных символах.

Возвращаемое значение

FilterGetDosName возвращает S_OK в случае успешного выполнения. В противном случае возвращается значение ошибки.

Комментарии

FilterGetDosName возвращает букву диска тома, если она имеется. Если тому не назначена буква диска, Функция FilterGetDosName возвращает путь к точке подключения тома (также называемой именем точки подключения). Если для тома не определены буквы диска или точки подключения, функция FilterGetDosName возвращает S_OK, а lpDosName получает значение NULL.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть fltuser.h (включая Fltuser.h)
Библиотека FltLib.lib
DLL FltLib.dll

См. также раздел

DefineDosDevice

FltGetVolumeName

IoQueryFileDosDeviceName

QueryDosDevice