Fungsi CertSrvRestorePrepareW (certbcli.h)

Artikel
23/02/2024

Fungsi CertSrvRestorePrepare menyiapkan instans Layanan Sertifikat untuk operasi pemulihan.

Sintaks

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

Parameter

[in] pwszServerName

Penunjuk ke nama komputer server untuk mempersiapkan operasi pemulihan. Nama ini bisa menjadi nama NetBIOS atau nama DNS.

[in] dwRestoreFlags

Bitfield yang mewakili kombinasi nilai dalam tabel berikut.

Nilai	Makna
CSRESTORE_TYPE_FULL	Pulihkan database Layanan Sertifikat, log, dan file terkait.

[out] phbc

Penunjuk ke handel konteks pencadangan Layanan Sertifikat (HCSBC).

Nilai kembali

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan keberhasilan, dan *phbc diatur ke HCSBC, yang dapat digunakan oleh API pemulihan Layanan Sertifikat lainnya.

Keterangan

Sebelum operasi pemulihan Layanan Sertifikat dapat terjadi, perlu untuk membuat HCSBC melalui CertSrvRestorePrepare. HCSBC ini dapat digunakan oleh berbagai fungsi pemulihan Layanan Sertifikat.

Catatan Ketika sesi pemulihan selesai, perlu memanggil CertSrvRestoreEnd untuk merilis HCSBC yang dihasilkan dari panggilan ke CertSrvRestorePrepare.

Nama fungsi ini dalam Certadm.dll adalah CertSrvRestorePrepareW. Anda harus menggunakan bentuk nama ini saat memanggil GetProcAddress. Selain itu, fungsi ini didefinisikan sebagai jenis FNCERTSRVRESTOREPREPAREW dalam file header Certbcli.h.

Untuk menjalankan panggilan ini, Anda harus memiliki hak istimewa pemulihan. Untuk informasi selengkapnya, lihat Mengatur Hak Istimewa Pencadangan dan Pemulihan.

Contoh

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);

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	certbcli.h (termasuk Certsrv.h)
Pustaka	Certadm.lib
DLL	Certadm.dll

Lihat juga

CertSrvRestoreEnd

GetProcAddress

Mengatur Hak Istimewa Pencadangan dan Pemulihan

Menggunakan Fungsi Pencadangan dan Pemulihan Layanan Sertifikat

Bagikan melalui