GetVolumePathNamesForVolumeNameW-Funktion (fileapi.h)

  • Artikel

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

Syntax

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

Parameter

[in] lpszVolumeName

Ein Volume-GUID-Pfad für das Volume. Ein Volume-GUID-Pfad hat die Form "\\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}\".

[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 zu speichern, enthält der Puffer so viel wie möglich von der Liste.

[in] cchBufferLength

Die Länge des lpszVolumePathNames-Puffers 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 zu enthalten, 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 fileapi.h (Einschließen von Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Eingebundene Ordner

Volumeverwaltungsfunktionen