BackupClusterDatabase-Funktion (clusapi.h)

Artikel
02/26/2024

[Diese Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Die Unterstützung für diese Funktion wurde in Windows Server 2008 entfernt, und diese Funktion macht nichts und gibt ERROR_CALL_NOT_IMPLEMENTED zurück.]

Erstellt eine Sicherung der Clusterdatenbank und aller Registrierungsprüfpunkte.

Syntax

DWORD BackupClusterDatabase(
  [in] HCLUSTER hCluster,
  [in] LPCWSTR  lpszPathName
);

Parameter

[in] hCluster

Handle für den zu sichernden Cluster.

[in] lpszPathName

Unicode-Zeichenfolge mit Null-Termin, die den Pfad angibt, zu dem die Sicherung erstellt werden soll. Clusterkonfigurationsinformationen werden an diesem Speicherort gespeichert. Hierbei handelt es sich um vertrauliche Daten, die geschützt werden sollten. Beispielsweise können diese Daten mithilfe einer Zugriffssteuerungsliste geschützt werden, um den Zugriff auf den Speicherort zu beschränken, an dem die Daten gespeichert sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, gibt sie einen der Systemfehlercodes zurück.

Hinweise

Im Idealfall sollte der angegebene Pfad ein Pfad sein, der für alle Clusterknoten sichtbar ist, z. B. ein UNC-Pfad. Der Pfad muss mindestens für den Knoten sichtbar sein, der derzeit besitzer der Quorumressource ist. Schließen Sie keinen Dateinamen in den Pfad ein, andernfalls schlägt die Funktion fehl, wodurch ERROR_DIRECTORY zurückgegeben wird. Der Pfad kann einen nachfolgenden umgekehrten Schrägstrich enthalten.

Eine Möglichkeit, sicherzustellen, dass ein geeigneter Pfad vorhanden ist, besteht darin, eine temporäre Netzwerkfreigabe wie folgt zu erstellen:

Rufen Sie die Funktion NetShareAdd auf, um eine temporäre Netzwerkfreigabe zu erstellen. Alle Clusterknoten müssen über Schreibzugriff auf diese Freigabe verfügen.
Rufen Sie BackupClusterDatabase auf, und geben Sie die temporäre Freigabe im lpszPathName-Parameter an.
Kopieren Sie die Sicherungsdateien (siehe unten) an einen oder mehrere sichere Speicherorte.
Rufen Sie die Funktion NetShareDel auf, um die Freigabe zu löschen.

Die Sicherung enthält die folgenden Dateien.

Pfad\Datei	BESCHREIBUNG
lpszPathName\chk????. Tmp	Momentaufnahmedateien.
lpszPathName\quolog.log	Die Quorumprotokolldatei.
lpszPathName\<GUID der Ressource>\*. CPT	Die Registrierungsprüfpunktdateien für die von der GUID identifizierte Ressource.
lpszPathName\<GUID der Ressource>\*. CPR	Die Kryptoprüfpunktdateien für die von der GUID identifizierte Ressource.
lpszPathName\Clusbackup.dat	Sicherungsabschlussmarkerdatei (schreibgeschützt, ausgeblendet, 0-Byte-Datei)

Nachfolgende BackupClusterDatabase-Vorgänge , die denselben lpszPath-Parameter verwenden, überschreiben die vorhandenen Sicherungsdateien.

Erstellen Sie nach Möglichkeit mehrere Kopien des Sicherungsverzeichnisses auf verschiedenen Medien, und speichern Sie diese Kopien an separaten Speicherorten.

Beispiele

Das folgende Beispiel veranschaulicht eine statische Sicherungsroutine. Ein ausführlicheres Beispiel mit RestoreClusterDatabase finden Sie unter Sichern und Wiederherstellen der Clusterkonfiguration. In diesem Beispiel wird die in der Failoverclusterdokumentation definierte Headerdatei ClusDocEx.h verwendet.


int main( void )
 {
  HCLUSTER hCluster     = NULL;
  WCHAR szClusterName[] = L"CLUSTER_NAME";
  WCHAR szPath[]        = L"\\\\ClusBack\\19991215";
  DWORD dwResult        = ERROR_SUCCESS;
 
  if( ( hCluster = OpenCluster( szClusterName ) ) != NULL )
   {
    dwResult = BackupClusterDatabase( hCluster, szPath );
    CloseCluster( hCluster );
   }
  else
    dwResult = GetLastError();

  if( dwResult == ERROR_SUCCESS )
   {
    wprintf( L"\nDone. The cluster database has been backed up to %s. ", szPath );
    wprintf( L"The backup consists of the following files:\n    chk????.tmp\n"
             L"    quolog.log\n    *.cpt\n    *.cpr\n\n" );
    return 0;
   }
  else
   {
    wprintf( L"The operation failed (%d)\n", dwResult );
    return 1;
   }
 }

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll

Weitere Informationen

Sicherungs- und Wiederherstellungsfunktionen

RestoreClusterDatabase

Freigeben über