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

Siehe auch

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Volumeverwaltungsfunktionen