GetVolumePathNamesForVolumeNameA-Funktion (winbase.h)

Artikel
03/03/2024

Ruft eine Liste von Laufwerkbuchstaben und eingebundenen Ordnerpfaden für das angegebene Volume ab.

Syntax

BOOL GetVolumePathNamesForVolumeNameA(
  [in]  LPCSTR lpszVolumeName,
  [out] LPCH   lpszVolumePathNames,
  [in]  DWORD  cchBufferLength,
  [out] PDWORD lpcchReturnLength
);

Parameter

[in] lpszVolumeName

Ein Volume-GUID-Pfad für das Volume. Ein Volume-GUID-Pfad hat das Format "\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx}".

[out] lpszVolumePathNames

Ein Zeiger auf einen Puffer, der die Liste der Laufwerkbuchstaben und eingebundenen Ordnerpfade empfängt. Die Liste ist ein Array von NULL-Zeichenfolgen, die durch ein zusätzliches NULL-Zeichen beendet werden. Wenn der Puffer nicht groß genug ist, um die vollständige Liste aufzunehmen, enthält der Puffer so viel wie möglich von der Liste.

[in] cchBufferLength

Die Länge des puffers lpszVolumePathNames in TCHARs, einschließlich aller NULL-Zeichen .

[out] lpcchReturnLength

Wenn der Aufruf erfolgreich ist, ist dieser Parameter die Anzahl der TCHARs , die in den Puffer lpszVolumePathNames kopiert wurden. Andernfalls ist dieser Parameter die Größe des Puffers, der für die vollständige Liste in TCHARs erforderlich ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Wenn der Puffer nicht groß genug ist, um die vollständige Liste aufzunehmen, wird der Fehlercode ERROR_MORE_DATA , und der Parameter lpcchReturnLength empfängt die erforderliche Puffergröße.

Hinweise

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)	No
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	No
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

SMB unterstützt keine Volumeverwaltungsfunktionen.

Beispiele

Ein Beispiel finden Sie unter Anzeigen von Volumepfaden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Eingebundene Ordner

Volumeverwaltungsfunktionen

Freigeben über