Función FilterGetDosName (fltuser.h)

Artículo
08/23/2023

La función FilterGetDosName devuelve el nombre del dispositivo MS-DOS que corresponde al nombre de volumen especificado.

Sintaxis

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

Parámetros

[in] lpVolumeName

Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre del volumen.

La cadena de entrada lpVolumeName puede ser cualquiera de las siguientes. La barra diagonal inversa final (\) es opcional.

Una letra de unidad, como "D:\"
Ruta de acceso a un punto de montaje de volumen, como "c:\mnt\edrive\"
Un identificador de volumen único (también denominado nombre GUID de volumen), como "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
Un nombre de dispositivo no persistente (también denominado nombre de destino o un nombre de dispositivo NT), como "\Device\HarddiskVolume1\"

Este parámetro es obligatorio y no puede ser NULL.

[out] lpDosName

Puntero a un búfer asignado por el autor de la llamada que recibe el nombre del dispositivo MS-DOS como una cadena de caracteres anchos terminada en NULL.

[in] dwDosNameBufferSize

Tamaño, en caracteres anchos, del búfer al que apunta lpDosName .

Valor devuelto

FilterGetDosName devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor de error.

Comentarios

FilterGetDosName devuelve la letra de unidad del volumen si tiene una. Si no se asigna ninguna letra de unidad al volumen, FilterGetDosName devuelve una ruta de acceso a un punto de montaje de volumen (también denominado nombre de punto de montaje). Si no se definen letras de unidad ni puntos de montaje para el volumen, FilterGetDosName devuelve S_OK y lpDosName recibe NULL.