CVssWriter::Initialize method (vswriter.h)

Artikel
03/08/2023

Menginisialisasi objek CVssWriter dan memungkinkan aplikasi penulis berinteraksi dengan VSS.

Inisialisasi adalah metode publik yang diterapkan oleh kelas dasar CVssWriter .

Sintaks

HRESULT Initialize(
  [in] VSS_ID                     WriterId,
  [in] LPCWSTR                    wszWriterName,
  [in] VSS_USAGE_TYPE             ut,
  [in] VSS_SOURCE_TYPE            st,
  [in] VSS_APPLICATION_LEVEL      nLevel,
  [in] DWORD                      dwTimeoutFreeze,
  [in] VSS_ALTERNATE_WRITER_STATE aws,
  [in] bool                       bIOThrottlingOnly,
  [in] LPCWSTR                    wszWriterInstanceName
);

Parameter

[in] WriterId

Pengidentifikasi unik global (GUID) dari kelas penulis.

[in] wszWriterName

String karakter lebar yang dihentikan null yang berisi nama penulis. String ini tidak dilokalkan.

[in] ut

Nilai enumerasi VSS_USAGE_TYPE yang menunjukkan bagaimana data yang dikelola oleh penulis digunakan pada sistem host.

[in] st

Nilai enumerasi VSS_SOURCE_TYPE yang menunjukkan jenis data yang dikelola oleh penulis.

[in] nLevel

Nilai enumerasi VSS_APPLICATION_LEVEL yang menunjukkan tingkat aplikasi di mana penulis menerima pemberitahuan peristiwa Freeze .

Nilai default untuk parameter ini adalah VSS_APP_FRONT_END.

[in] dwTimeoutFreeze

Waktu maksimum yang diizinkan, dalam milidetik, antara penerimaan penulis atas pemberitahuan peristiwa Freeze dan penerimaan pemberitahuan peristiwa Thaw yang cocok dari VSS. Setelah waktu habis berakhir, metode CVssWriter::OnAbort penulis dipanggil secara otomatis.

Nilai default untuk parameter ini adalah 60000.

[in] aws

Nilai enumerasi VSS_ALTERNATE_WRITER_STATE yang menunjukkan apakah penulis memiliki penulis alternatif terkait.

Nilai default untuk parameter ini adalah VSS_AWS_NO_ALTERNATE_WRITER. Penelepon tidak boleh mengambil alih nilai default ini. Parameter ini dicadangkan untuk digunakan di masa mendatang.

[in] bIOThrottlingOnly

Atur parameter ini ke true jika metode pembatasan I/O diaktifkan, atau salah jika sebaliknya.

Nilai default untuk parameter ini adalah false. Penelepon tidak boleh mengambil alih nilai default ini. Parameter ini dicadangkan untuk digunakan di masa mendatang.

[in] wszWriterInstanceName

String karakter lebar yang dihentikan null yang berisi nama instans penulis.

Nilai default untuk parameter ini adalah NULL. Jika penulis memiliki beberapa instans dan memerlukan peristiwa pemulihan, parameter ini diperlukan dan tidak boleh NULL. Untuk detailnya, lihat bagian Keterangan berikut ini.

Windows Server 2003 dan Windows XP: Sebelum Windows Server 2003 dengan SP1, parameter ini dicadangkan untuk penggunaan sistem, dan pemanggil tidak boleh mengambil alih nilai default.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Berhasil menginisialisasi objek penulis.
S_FALSE	Objek penulis tidak dapat diinisialisasi; infrastruktur penulis VSS tidak aktif karena Windows dalam mode aman atau sedang disiapkan.
E_ACCESSDENIED	Penelepon bukan administrator.
E_INVALIDARG	Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY	Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_UNEXPECTED	Kesalahan tak terduga. Kode kesalahan dicatat dalam file log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows Server 2008 R2 dan Windows 7. E_UNEXPECTED digunakan sebagai gantinya.

Keterangan

VSS menetapkan ID instans penulis unik untuk setiap instans aplikasi penulis. Jika lebih dari satu instans ada pada sistem pada saat yang sama (misalnya, jika beberapa server SQL berjalan pada sistem), setiap penulis secara unik diidentifikasi oleh kombinasi ID kelas penulis dan ID instans penulisnya.

Parameter wszWriterInstanceName memungkinkan penulis multi-instans untuk menentukan nama persisten untuk setiap instans penulis sebagai string yang dapat dibaca manusia. Nama ini harus unik di semua instans penulis pada sistem. Jika penulis memiliki beberapa instans dan memerlukan peristiwa pemulihan, penulis harus menentukan string non-NULL untuk parameter ini. VSS menggunakan nama instans untuk memulihkan penulis multi-instans dengan benar.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	vswriter.h (termasuk Vss.h, VsWriter.h)
Pustaka	VssApi.lib