Freigeben über

ClusterGetVolumeNameForVolumeMountPoint-Funktion (resapi.h)

  • Artikel

[ClusterGetVolumeNameForVolumeMountPoint ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen GetVolumeNameForVolumeMountPoint.]

Ruft einen GUID-Pfad des Clustervolumes für das Volume ab, das dem angegebenen CSV-Bereitstellungspunkt (Laufwerkbuchstabe, Volume-GUID-Pfad oder eingebundener Ordner) zugeordnet ist.

Syntax

BOOL ClusterGetVolumeNameForVolumeMountPoint(
  [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 eines Laufwerkbuchstabens (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 die Form "\?\Volume{GUID}", wobei GUID eine GUID ist, die das Volume identifiziert. Wenn mehrere Volume-GUID-Pfade für das Volume vorhanden sind, wird nur der erste im Cache des Bereitstellungs-Managers zurückgegeben. Die zurückgegebene Zeichenfolge hat das für IVssBackupComponents::AddToSnapshotSet und IVssBackupComponents::IsVolumeSupported erforderliche Format.

[in] cchBufferLength

Die Länge des Ausgabepuffers in WCHARs. Eine angemessene Größe für den Puffer, um den größtmöglichen Volume-GUID-Pfad aufzunehmen, beträgt 51 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. Wenn die CSV-Eingabe nicht lokal eingebunden ist, schlägt der Aufruf mit einem ERROR_CSV_VOLUME_NOT_LOCAL (5951) Fehler fehl.

Hinweise

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

  • Eingabe: "C:\ClusterStorage\Volume31\"

    Ausgabe: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

  • Eingabe: "C:\ClusterStorage\Volume31\"

    Ausgabe: Die Funktion schlägt fehl und legt den letzten Fehler ERROR_CSV_VOLUME_NOT_LOCAL fest (5951).

    Hinweis Das für die Eingabe angegebene CSV-Volume wird für direkte E/A-Vorgänge nicht lokal eingebunden.
     
  • Eingabe: "\\?\C:\ClusterStorage\Volume31\Filename.Ext"

    Ausgabe: Die Funktion schlägt fehl und legt den letzten Fehler ERROR_INVALID_PARAMETER (87) fest.

  • Eingabe: "C:\ClusterStorage\Volume31\File\that\does\not\exist"

    Ausgabe: Die Funktion schlägt fehl und legt den letzten Fehler ERROR_INVALID_NAME (123) fest.

  • Eingabe: "C:\ClusterStorage\Volume31\Directory\that\does\not\exist\"

    Ausgabe: Die Funktion schlägt fehl und legt den letzten Fehler ERROR_INVALID_NAME (123) fest.

  • Eingabe: "\\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\"

    Ausgabe: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

  • Eingabe: "\\?\Volume{de8b99bb-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31\"

    Ausgabe: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

    Hinweis Das Volume in der Ausgabe ist eine CSV-Datei und unterscheidet sich von dem Systemvolume, das Teil der Eingabe war.
     
  • Eingabe: "\\?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31\"

    Ausgabe: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

  • Eingabe: "\\?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31\"

    Ausgabe: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

Windows Server 2008 R2: In der ersten Version von ResApi.h, die die ClusterGetVolumeNameForVolumeMountPoint-Funktion enthält, wurden TCHAR-basierte Datentypen anstelle von WCHAR-basierten Datentypen verwendet. Die UNICODE-Präprozessordefinition muss festgelegt werden, bevor ResApi.h eingeschlossen wird. 
#define UNICODE 1
#include <ResApi.h>

Die ClusterGetVolumeNameForVolumeMountPoint-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

GetVolumeNameForVolumeMountPoint

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::IsVolumeSupported