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.

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

Vea también

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Funciones de administración de volúmenes