GetLogicalDriveStringsW-Funktion (fileapi.h)
Füllt einen Puffer mit Zeichenfolgen, die gültige Laufwerke im System angeben.
Syntax
DWORD GetLogicalDriveStringsW(
[in] DWORD nBufferLength,
[out] LPWSTR lpBuffer
);
Parameter
[in] nBufferLength
Die maximale Größe des Puffers, auf den lpBuffer in TCHARs verweist. Diese Größe enthält nicht das abschließende NULL-Zeichen. Wenn dieser Parameter null ist, wird lpBuffer nicht verwendet.
[out] lpBuffer
Ein Zeiger auf einen Puffer, der eine Reihe von NULL-beendeten Zeichenfolgen empfängt, eine für jedes gültige Laufwerk im System sowie ein zusätzliches NULL-Zeichen. Jede Zeichenfolge ist ein Gerätename.
Rückgabewert
Wenn die Funktion erfolgreich ist, entspricht der Rückgabewert der Länge (in Zeichen) der in den Puffer kopierten Zeichenfolgen, ohne das abschließende NULL-Zeichen. Beachten Sie, dass ein ANSI-ASCII-NULL-Zeichen ein Byte verwendet, ein Unicode-Nullzeichen (UTF-16) jedoch zwei Bytes verwendet.
Wenn der Puffer nicht groß genug ist, ist der Rückgabewert größer als nBufferLength. Dies ist die Größe des Puffers, der zum Halten der Laufwerkszeichenfolgen erforderlich ist.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.
Hinweise
Jede Zeichenfolge im Puffer kann überall dort verwendet werden, wo ein Stammverzeichnis erforderlich ist, z. B. für die Funktionen GetDriveType und GetDiskFreeSpace .
Diese Funktion gibt eine Verkettung der Laufwerke im globalen und lokalen MS-DOS-Gerätenamespace zurück. Wenn in beiden Namespaces ein Laufwerk vorhanden ist, gibt diese Funktion den Eintrag im Namespace Lokales MS-DOS-Gerät zurück. Weitere Informationen finden Sie unter Definieren eines MS DOS-Gerätenamens.
Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
| Technologie | Unterstützt |
|---|---|
| SMB 3.0-Protokoll (Server Message Block) | Nein |
| SMB 3.0 Transparent Failover (TFO) | Nein |
| SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) | Nein |
| Dateisystem mit freigegebenen Clustervolumes (CsvFS) | Ja |
| Robustes Dateisystem (Resilient File System, ReFS) | Ja |
SMB unterstützt keine Volumeverwaltungsfunktionen.
Beispiele
Ein Beispiel finden Sie unter Abrufen eines Dateinamens aus einem Dateihandle.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | fileapi.h (Einschließen von Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |