Función GetLogicalDriveStringsW (fileapi.h)
Rellena un búfer con cadenas que especifican unidades válidas en el sistema.
Sintaxis
DWORD GetLogicalDriveStringsW(
[in] DWORD nBufferLength,
[out] LPWSTR lpBuffer
);
Parámetros
[in] nBufferLength
Tamaño máximo del búfer al que apunta lpBuffer, en TCHAR. Este tamaño no incluye el carácter nulo de terminación. Si este parámetro es cero, no se usa lpBuffer .
[out] lpBuffer
Puntero a un búfer que recibe una serie de cadenas terminadas en NULL, una para cada unidad válida del sistema, además de un carácter nulo adicional. Cada cadena es un nombre de dispositivo.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es la longitud, en caracteres, de las cadenas copiadas en el búfer, sin incluir el carácter nulo de terminación. Tenga en cuenta que un carácter NULL ANSI-ASCII usa un byte, pero un carácter Nulo Unicode (UTF-16) usa dos bytes.
Si el búfer no es lo suficientemente grande, el valor devuelto es mayor que nBufferLength. Es el tamaño del búfer necesario para contener las cadenas de unidad.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, use la función GetLastError .
Comentarios
Cada cadena del búfer se puede usar siempre que se requiera un directorio raíz, como para las funciones GetDriveType y GetDiskFreeSpace .
Esta función devuelve una concatenación de las unidades en los espacios de nombres global y local del dispositivo MS-DOS. Si existe una unidad en ambos espacios de nombres, esta función devolverá la entrada en el espacio de nombres Local MS-DOS Device. Para obtener más información, consulte Definición de un nombre de dispositivo MS DOS.
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.
Ejemplos
Para obtener un ejemplo, vea Obtener un nombre de archivo a partir de un identificador de archivo.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | fileapi.h (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |