Función GetLogicalDriveStringsW (fileapi.h)

  • Artículo

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

Vea también

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Funciones de administración de volúmenes