GetVolumeNameForVolumeMountPointW-Funktion (fileapi.h)
Ruft einen Volume-GUID-Pfad für das Volume ab, das dem angegebenen Volumebereitstellungspunkt zugeordnet ist (Laufwerkbuchstabe, Volume-GUID-Pfad oder eingebundener Ordner).
Syntax
BOOL GetVolumeNameForVolumeMountPointW(
[in] LPCWSTR lpszVolumeMountPoint,
[out] LPWSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parameter
[in] lpszVolumeMountPoint
Ein Zeiger auf eine Zeichenfolge, die den Pfad eines eingebundenen Ordners (z. B. "Y:\MountX\") oder einen Laufwerkbuchstaben (z. B. "X:\") enthält. Die Zeichenfolge muss mit einem nachfolgenden umgekehrten Schrägstrich ('\') enden.
[out] lpszVolumeName
Ein Zeiger auf eine Zeichenfolge, die den Volume-GUID-Pfad empfängt . Dieser Pfad hat das Format "\\?\Volume{GUID}\", wobei GUID eine GUID ist, die das Volume identifiziert. Wenn mehr als ein Volume-GUID-Pfad für das Volume vorhanden ist, wird nur der erste im Cache des Bereitstellungs-Managers zurückgegeben.
[in] cchBufferLength
Die Länge des Ausgabepuffers in TCHARs. Eine angemessene Größe für den Puffer, um den größtmöglichen Volume-GUID-Pfad aufzunehmen, beträgt 50 Zeichen.
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.
Hinweise
Verwenden Sie GetVolumeNameForVolumeMountPoint , um einen Volume-GUID-Pfad für die Verwendung mit Funktionen wie SetVolumeMountPoint und FindFirstVolumeMountPoint abzurufen, die einen Volume-GUID-Pfad als Eingabeparameter erfordern. Weitere Informationen zu Volume-GUID-Pfaden finden Sie unter Benennen eines Volumes.
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) | Nein |
SMB unterstützt keine Volumeverwaltungsfunktionen.
Bereitstellungspunkte werden von ReFS-Volumes nicht unterstützt.
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 |