CertSrvBackupPrepareW-Funktion (certbcli.h)

Artikel
03/01/2024

Die CertSrvBackupPrepare-Funktion wird verwendet, um einen Certificate Services-Server für Sicherungsvorgänge vorzubereiten.

Syntax

HRESULT CERTBCLI_API CertSrvBackupPrepareW(
  [in]  WCHAR const *pwszServerName,
  [in]  ULONG       grbitJet,
  [in]  ULONG       dwBackupFlags,
  [out] HCSBC       *phbc
);

Parameter

[in] pwszServerName

Ein Zeiger auf den Computernamen des Servers zur Vorbereitung der Onlinesicherung. Dieser Name kann der NetBIOS-Name oder der DNS-Name sein.

[in] grbitJet

Wert, der von der Datenbank-Engine verwendet wird; Dieser Wert sollte auf 0 festgelegt werden.

[in] dwBackupFlags

Gibt den Sicherungstyp an. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
CSBACKUP_TYPE_FULL	Sichern Sie die Zertifikatdienste-Datenbank, Protokolle und zugehörige Dateien.
CSBACKUP_TYPE_LOGS_ONLY	Sichern Sie nur die Protokolldateien.

[out] phbc

Ein Zeiger auf ein Zertifikatdienste-Sicherungskontexthandle (HCSBC).

Rückgabewert

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt den Erfolg an, und *phbc wird auf einen HCSBC festgelegt, der von anderen Certificate Services-Sicherungs-APIs verwendet werden kann.

Hinweise

Bevor eine Certificate Services-Sicherung durchgeführt werden kann, muss ein HCSBC mithilfe von CertSrvBackupPrepare erstellt werden. Der resultierende HCSBC ist ein notwendiger Parameter von Certificate Services-Sicherungsfunktionen, die zum Auflisten, Öffnen, Lesen und Schließen von Dateien sowie zum Abschneiden der Protokolldateien verwendet werden können.

Hinweis Wenn die Sicherungssitzung abgeschlossen ist, muss CertSrvBackupEnd aufgerufen werden, um den HCSBC freizugeben, der aus dem Aufruf von CertSrvBackupPrepare resultiert.

Der Name dieser Funktion in Certadm.dll lautet CertSrvBackupPrepareW. Sie müssen diese Form des Namens verwenden, wenn Sie GetProcAddress aufrufen. Außerdem wird diese Funktion als Typ FNCERTSRVBACKUPPREPAREW in der Headerdatei Certbcli.h definiert.

Zum Ausführen dieses Aufrufs müssen Sie über die Sicherungsberechtigung verfügen. Ausführliche Informationen finden Sie unter Festlegen der Sicherungs- und Wiederherstellungsberechtigungen.

Beispiele

WCHAR *    wszServer = L"MyCertServerMachine";
FNCERTSRVBACKUPPREPAREW* pfnBackupPrepare;
char * szBackPrepFunc = "CertSrvBackupPrepareW";
HINSTANCE  hInst=0;
HCSBC      hCSBC=NULL;
HRESULT    hr=0;

// Load the DLL.
hInst = LoadLibrary(L"Certadm.dll");
if ( NULL == hInst )
{
    printf("Failed LoadLibrary, error=%d\n",
            GetLastError() );
    exit(1); // Or other appropriate error action.
}
// Get the address for the desired function.
pfnBackupPrepare = (FNCERTSRVBACKUPPREPAREW*)GetProcAddress( hInst,
                                        szBackPrepFunc );
if ( NULL == pfnBackupPrepare )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szBackPrepFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// Prepare CertServ for backup.
hr = pfnBackupPrepare(wszServer,
                      0,
                      CSBACKUP_TYPE_FULL,
                      &hCSBC);
if (FAILED(hr))
{
    printf("Failed pfnBackupPrepare call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}

// Use the HCSBC for backup operations.
// ...

// When done processing, release the HCSBC context
// by calling CertSrvBackupEnd (not shown here).
// ...


// Done processing, free the DLL.
if (hInst)
    FreeLibrary(hInst);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certbcli.h (include Certsrv.h)
Bibliothek	Certadm.lib
DLL	Certadm.dll

Weitere Informationen

CertSrvBackupEnd

Verwenden der Sicherungs- und Wiederherstellungsfunktionen für Zertifikatdienste

Freigeben über