Función GetDriveTypeA (fileapi.h)

  • Artículo

Determina si una unidad de disco es extraíble, fija, CD-ROM, disco RAM o unidad de red.

Para determinar si una unidad es de tipo USB, llame a SetupDiGetDeviceRegistryProperty y especifique la propiedad SPDRP_REMOVAL_POLICY .

Sintaxis

UINT GetDriveTypeA(
  [in, optional] LPCSTR lpRootPathName
);

Parámetros

[in, optional] lpRootPathName

Directorio raíz de la unidad.

Se requiere una barra diagonal inversa final. Si este parámetro es NULL, la función usa la raíz del directorio actual.

Valor devuelto

El valor devuelto especifica el tipo de unidad, que puede ser uno de los valores siguientes.

Código o valor devuelto Descripción
DRIVE_UNKNOWN
0
 No se puede determinar el tipo de unidad.
DRIVE_NO_ROOT_DIR
1
 La ruta de acceso raíz no es válida; por ejemplo, no hay ningún volumen montado en la ruta de acceso especificada.
DRIVE_REMOVABLE
2
 La unidad tiene medios extraíbles; por ejemplo, una unidad de disquete, una unidad usb o un lector de tarjetas flash.
DRIVE_FIXED
3
 La unidad tiene medios fijos; por ejemplo, una unidad de disco duro o una unidad flash.
DRIVE_REMOTE
4
 La unidad es una unidad remota (red).
DRIVE_CDROM
5
 La unidad es una unidad de CD-ROM.
DRIVE_RAMDISK
6
 La unidad es un disco RAM.

Comentarios

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 No
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) Sí
Sistema de archivos resistente a errores (ReFS) Sí
 

SMB no admite funciones de administración de volúmenes.

Nota

El encabezado fileapi.h define GetDriveType como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado fileapi.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

GetDiskFreeSpace

Funciones de administración de volúmenes