Compartir a través de

Función GetDriveTypeA (fileapi.h)

  • Artículo

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

Para determinar si una unidad es una unidad 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 siguientes valores.

Código y valor devueltos 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 CD-ROM.
DRIVE_RAMDISK
6
 La unidad es un disco RAM.

Observaciones

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

Tecnología Soportado
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 (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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
encabezado de fileapi.h (incluya Windows.h)
biblioteca de Kernel32.lib
DLL de Kernel32.dll

Consulte también

GetDiskFreeSpace

funciones de administración de volúmenes de