Función GetLogicalDriveStringsW (fileapi.h)

Rellena un búfer con cadenas que especifican unidades válidas en el sistema.

Syntax

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 valor incluye espacio para 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 NULL 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 ANSI-ASCII null usa un byte, pero un carácter Null 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 se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, use la función GetLastError .

Observaciones

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 MS-DOS Dispositivo. Si existe una unidad en ambos espacios de nombres, esta función devolverá la entrada en el espacio de nombres local MS-DOS dispositivo. 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 siguientes tecnologías.

SMB no admite funciones de administración de volúmenes.

Examples

Para obtener un ejemplo, vea Obtener un nombre de archivo de un identificador de archivo.

Requisitos

Consulte también

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Funciones de administración de volúmenes