GetVolumePathNamesForVolumeNameW-Funktion (fileapi.h)
Ruft eine Liste der Laufwerkbuchstaben und bereitgestellten Ordnerpfade 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 ist das Format "\\?\Volume{xxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx}\".
[out] lpszVolumePathNames
Ein Zeiger auf einen Puffer, der die Liste der Laufwerkbuchstaben und bereitgestellten Ordnerpfade empfängt. Die Liste ist ein Array von Zeichenfolgen, die durch ein zusätzliches NULL- Zeichen beendet werden. Wenn der Puffer nicht groß genug ist, um die vollständige Liste zu enthalten, enthält der Puffer so viel wie möglich.
[in] cchBufferLength
Die Länge des lpszVolumePathNames- Puffers in WCHARs-, einschließlich aller NULL- Zeichen.
[out] lpcchReturnLength
Wenn der Aufruf erfolgreich ist, ist dieser Parameter die Anzahl der WCHARs in den lpszVolumePathNames Puffer kopiert. Andernfalls ist dieser Parameter die Größe des Puffers, der zum Halten der vollständigen Liste erforderlich ist, in WCHARs.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten. Wenn der Puffer nicht groß genug ist, um die vollständige Liste zu enthalten, wird der Fehlercode ERROR_MORE_DATA, und der lpcchReturnLength Parameter empfängt die erforderliche Puffergröße.
Bemerkungen
In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
| Technologie | Abgestützt |
|---|---|
| Server Message Block (SMB) 3.0-Protokoll | Nein |
| SMB 3.0 Transparent Failover (TFO) | Nein |
| SMB 3.0 mit Skalierungsdateifreigaben (SO) | Nein |
| Freigegebenes Clustervolumedateisystem (CsvFS) | Ja |
| Resilient File System (ReFS) | Ja |
SMB unterstützt keine Volumeverwaltungsfunktionen.
Beispiele
Ein Beispiel finden Sie unter Anzeigen von Volumepfaden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | fileapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |