GetVolumeNameForVolumeMountPointA-Funktion (winbase.h)

  • Artikel

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 GetVolumeNameForVolumeMountPointA(
  [in]  LPCSTR lpszVolumeMountPoint,
  [out] LPSTR  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) 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) No
 

SMB unterstützt keine Volumeverwaltungsfunktionen.

Bereitstellungspunkte werden von ReFS-Volumes nicht unterstützt.

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

DeleteVolumeMountPoint

GetVolumePathName

Eingebundene Ordner

SetVolumeMountPoint

Volumeverwaltungsfunktionen