CertSrvRestorePrepareW-Funktion (certbcli.h)

Artikel
08/22/2023

Die CertSrvRestorePrepare-Funktion bereitet einen Certificate Services-instance für Wiederherstellungsvorgänge vor.

Syntax

HRESULT CERTBCLI_API CertSrvRestorePrepareW(
  [in]  WCHAR const *pwszServerName,
  [in]  ULONG       dwRestoreFlags,
  [out] HCSBC       *phbc
);

Parameter

[in] pwszServerName

Ein Zeiger auf den Computernamen des Servers zur Vorbereitung von Wiederherstellungsvorgängen. Dieser Name kann der NetBIOS-Name oder der DNS-Name sein.

[in] dwRestoreFlags

Ein Bitfeld, das die Kombination von Werten in der folgenden Tabelle darstellt.

Wert	Bedeutung
CSRESTORE_TYPE_FULL	Stellen Sie die Zertifikatdienste-Datenbank, Protokolle und zugehörige Dateien wieder her.

[out] phbc

Ein Zeiger auf ein Zertifikatdienste-Sicherungskontexthandle (HCSBC).

Rückgabewert

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

Hinweise

Bevor ein Certificate Services-Wiederherstellungsvorgang ausgeführt werden kann, muss mithilfe von CertSrvRestorePrepare ein HCSBC erstellt werden. Dieser HCSBC kann von verschiedenen Wiederherstellungsfunktionen für Zertifikatdienste verwendet werden.

Hinweis Wenn die Wiederherstellungssitzung abgeschlossen ist, muss CertSrvRestoreEnd aufgerufen werden, um den HCSBC freizugeben, der aus dem Aufruf von CertSrvRestorePrepare resultiert.

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

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

Beispiele

FNCERTSRVRESTOREPREPAREW*  pfnRestorePrepare;
char * szRestorePrepFunc = "CertSrvRestorePrepareW";
HCSBC      hCSBC=NULL;
HINSTANCE  hInst=0;
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.
pfnRestorePrepare = (FNCERTSRVRESTOREPREPAREW*)GetProcAddress( hInst,
                                          szRestorePrepFunc );
if ( NULL == pfnRestorePrepare )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szRestorePrepFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// Prepare CertServ for restoration.
hr = pfnRestorePrepare(wszServer,
                       CSRESTORE_TYPE_FULL,
                       &hCSBC);

if (FAILED(hr))
{
    printf("Failed pfnRestorePrepare call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}

// Use the HCSBC for restore operations.
// ...


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

// 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

CertSrvRestoreEnd

GetProcAddress

Festlegen der Sicherungs- und Wiederherstellungsberechtigungen

Verwenden der Sicherungs- und Wiederherstellungsfunktionen für Zertifikatdienste

Freigeben über