Función GetDriveTypeA (fileapi.h)
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 |
|---|---|
|
No se puede determinar el tipo de unidad. |
|
La ruta de acceso raíz no es válida; por ejemplo, no hay ningún volumen montado en la ruta de acceso especificada. |
|
La unidad tiene medios extraíbles; por ejemplo, una unidad de disquete, una unidad usb o un lector de tarjetas flash. |
|
La unidad tiene medios fijos; por ejemplo, una unidad de disco duro o una unidad flash. |
|
La unidad es una unidad remota (red). |
|
La unidad es una unidad de CD-ROM. |
|
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 |