Fungsi CertSrvBackupOpenFileW (certbcli.h)

Fungsi CertSrvBackupOpenFile membuka file untuk cadangan.

Sintaks

HRESULT CERTBCLI_API CertSrvBackupOpenFileW(
  [in]  HCSBC         hbc,
  [in]  WCHAR const   *pwszAttachmentName,
  [in]  DWORD         cbReadHintSize,
  [out] LARGE_INTEGER *pliFileSize
);

Parameter

[in] hbc

Handel ke konteks pencadangan Layanan Sertifikat .

[in] pwszAttachmentName

Nama file yang akan dibuka untuk tujuan pencadangan. Nama file ini akan diurai dari daftar yang dihasilkan melalui CertSrvBackupGetBackupLogs atau CertSrvBackupGetDatabaseNames. Perhatikan bahwa nama yang dikembalikan oleh CertSrvBackupGetBackupLogs dan CertSrvBackupGetDatabaseNames harus memiliki awalan WCHAR tunggal CSBFT_* yang dilucuti sebelum CertSrvBackupOpenFile dipanggil.

[in] cbReadHintSize

Jumlah byte yang digunakan sebagai petunjuk saat file dibaca oleh CertSrvBackupRead. Parameter cbReadHintSize yang diteruskan ke panggilan CertSrvBackupOpenFile pertama untuk konteks cadangan digunakan untuk mengukur buffer baca. Teruskan nol untuk parameter ini, dan buffer akan berukuran pada ukuran yang cukup efisien yang dipilih oleh CertSrvBackupOpenFile. Jika memori tidak cukup tersedia, ukuran buffer akan dikurangi sampai alokasi memori berhasil atau sampai ukuran buffer mencapai nilai minimum yang mungkin. Teruskan ukuran bukan nol untuk menyebabkan CertSrvBackupOpenFile mengukur buffer ke kekuatan dua di dekat nilai cbReadHintSize. Implementasinya hanya akan memilih kekuatan dua antara 64 KB dan 4 MB.

[out] pliFileSize

Penunjuk ke nilai LARGE_INTEGER yang menunjukkan jumlah byte dalam file.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Gunakan fungsi ini untuk membuka file untuk tujuan pencadangan. Setelah Anda selesai menggunakan file, tutup file dengan memanggil fungsi CertSrvBackupClose .

Nama fungsi ini dalam Certadm.dll adalah CertSrvBackupOpenFileW. Anda harus menggunakan bentuk nama ini saat memanggil GetProcAddress. Selain itu, fungsi ini didefinisikan sebagai jenis FNCERTSRVBACKUPOPENFILEW di Certbcli.h.

Contoh

FNCERTSRVBACKUPOPENFILEW* pfnOpenFile;
char * szBackupOpenFunc = "CertSrvBackupOpenFileW";
LARGE_INTEGER liFileSize;
HRESULT       hr=0;

// Get the address for the desired function.    
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnOpenFile = (FNCERTSRVBACKUPOPENFILEW*)GetProcAddress(hInst,
                                         szBackupOpenFunc);
if ( NULL == pfnOpenFile )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
            szBackupOpenFunc,
            GetLastError() );
    exit(1); // or other appropriate error action
}

// Open the file.
// hCSBC was set by an earlier call to CertSrvBackupPrepare.
// pwszFile specifies the name of a file.
// This name could have resulted from parsing the
// output from CertSrvBackupGetDatabaseNames, and so on.
hr = pfnOpenFile(hCSBC,
                pwszFile,
                0,
                &liFileSize);
if (FAILED(hr))
{
    printf("Failed pfnOpenFile call [%x] %ws\n",
           hr,
           pwszFile);
           exit(1); // Or other appropriate error action.
}

// Use the opened file as needed.
// When you have finished using the file, call CertSrvBackupClose.
// ...

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

CertSrvBackupClose

CertSrvBackupRead

Menggunakan Fungsi Pencadangan dan Pemulihan Layanan Sertifikat