ClusterPrepareSharedVolumeForBackup-Funktion (resapi.h)
[ClusterPrepareSharedVolumeForBackup ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Ein Aufruf dieser Funktion ist nicht erforderlich. Die Funktion übernimmt nichts anderes, als den Volumepfad und den Volumenamen abzurufen.
Windows Server 2008 R2: Bereitet ein freigegebenes Clustervolume (CSV) für die Sicherung vor. Dadurch wird die CSV lokal eingebunden, an diesen Clusterknoten angeheftet, direkte E/A-Vorgänge deaktiviert und der Volumestatus auf "Sicherung in Bearbeitung" festgelegt.
Syntax
DWORD ClusterPrepareSharedVolumeForBackup(
[in] LPCWSTR lpszFileName,
[out] LPWSTR lpszVolumePathName,
[in, out] LPDWORD lpcchVolumePathName,
[out] LPWSTR lpszVolumeName,
[in, out] LPDWORD lpcchVolumeName
);
Parameter
[in] lpszFileName
Pfad zu einem Verzeichnis oder einer Datei auf einem freigegebenen Clustervolume.
[out] lpszVolumePathName
Adresse des Puffers, der den CSV-Analysepunkt empfängt.
[in, out] lpcchVolumePathName
Adresse eines DWORD-Werts , der bei der Eingabe die Größe des Puffers (in WCHAR-Zeichen ) enthält, auf die der lpszVolumePathName-Parameter verweist, und in der Ausgabe die Größe der in diesen Puffer geschriebenen Zeichenfolge enthält. Wenn die Größe der Eingabe nicht groß genug ist, schlägt die Funktion fehl, gibt ERROR_MORE_DATA zurück, und legt DWORD auf die erforderliche Größe fest.
[out] lpszVolumeName
Adresse des Puffers, der den VOLUME-GUID-Pfad für die CSV-Datei empfängt.
[in, out] lpcchVolumeName
Adresse eines DWORD-Werts , der bei der Eingabe die Größe des Puffers (in WCHAR-Zeichen ) enthält, auf die der lpszVolumeName-Parameter verweist und in der Ausgabe die Größe der in diesen Puffer geschriebenen Zeichenfolge enthält. Wenn die Größe der Eingabe nicht groß genug ist, schlägt die Funktion fehl, gibt ERROR_MORE_DATA zurück, und legt DWORD auf die erforderliche Größe fest.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.
Wenn die Funktion fehlschlägt, gibt sie einen der Systemfehlercodes zurück.
Hinweise
Die ClusterPrepareSharedVolumeForBackup-Funktion muss von einem Knoten des Clusters aufgerufen werden.
Anforderungen
| 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