ClusterGetVolumePathName-Funktion (resapi.h)

Artikel
08/25/2023

[ClusterGetVolumePathName ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen GetVolumePathName.]

Ruft den Volumebereitstellungspunkt auf dem Cluster ab, in dem der angegebene Pfad eingebunden ist.

Syntax

BOOL ClusterGetVolumePathName(
  [in]  LPCWSTR lpszFileName,
  [out] LPWSTR  lpszVolumePathName,
  [in]  DWORD   cchBufferLength
);

Parameter

[in] lpszFileName

Ein Zeiger auf die Eingabepfadzeichenfolge. Sowohl absolute als auch relative Datei- und Verzeichnisnamen, z. B. ".", sind in diesem Pfad akzeptabel.

Wenn Sie einen relativen Verzeichnis- oder Dateinamen ohne Volumequalifizierer angeben, gibt ClusterGetVolumePathName den Laufwerkbuchstaben des aktuellen Volumes zurück.

Wenn es sich bei diesem Parameter um eine leere Zeichenfolge "" handelt, schlägt die Funktion fehl, aber der letzte Fehler wird auf ERROR_SUCCESS festgelegt.

[out] lpszVolumePathName

Ein Zeiger auf eine Zeichenfolge, die den Volumebereitstellungspunkt für den Eingabepfad empfängt.

[in] cchBufferLength

Die Länge des Ausgabepuffers in WCHARs.

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

Die folgenden Beispiele können hilfreich sein. In diesen Beispielen ist "Filename.Ext" vorhanden, aber "Path\that\does\not\exist" nicht.

Eingabe: "C:\ClusterStorage\Volume31\Filename.Ext"
Ausgabe: "C:\ClusterStorage\Volume31"
Eingabe: "\\?\C:\ClusterStorage\Volume31\Filename.Ext"
Ausgabe: "\?\C:\ClusterStorage\Volume31"
Eingabe: "C:\ClusterStorage\Volume31\Path\that\does\not\exist"
Ausgabe: "C:\ClusterStorage\Volume31"
Eingabe: "\\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31\Filename.Ext"
Ausgabe: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31"
Eingabe: "\\?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31\Filename.Ext"
Ausgabe: "\?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31"
Eingabe: "\\?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31\Filename.Ext"
Ausgabe: "\?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31"

Windows Server 2008 R2: In der ersten Version von ResApi.h, die die ClusterGetVolumePathName-Funktion enthält, wurden TCHAR-basierte Datentypen anstelle von WCHAR-basierten Datentypen verwendet. Die UNICODE-Präprozessordefinition muss festgelegt werden, bevor ResApi.h enthalten ist.

#define UNICODE 1
#include <ResApi.h>

Die ClusterGetVolumePathName-Funktion muss von einem Knoten des Clusters aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 Enterprise, Windows Server 2008 R2 Datacenter
Zielplattform	Windows
Kopfzeile	resapi.h
Bibliothek	ResUtils.Lib
DLL	ResUtils.Dll

Weitere Informationen

Sichern und Wiederherstellen der Failoverclusterkonfiguration mithilfe von VSS

Sicherungs- und Wiederherstellungsfunktionen

Freigeben über