CVssWriterEx::InitializeEx method (vswriter.h)
Menginisialisasi objek CVssWriterEx dan memungkinkan aplikasi penulis berinteraksi dengan VSS. Tidak seperti metode Inisialisasi , metode InitializeEx memungkinkan pemanggil untuk menentukan informasi versi penulis.
InitializeEx adalah metode publik yang diterapkan oleh kelas dasar CVssWriterEx .
Penulis harus memanggil Initialize atau InitializeEx, tetapi tidak keduanya.
Sintaks
HRESULT InitializeEx(
[in] VSS_ID WriterId,
[in] LPCWSTR wszWriterName,
[in] DWORD dwMajorVersion,
[in] DWORD dwMinorVersion,
[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] dwMajorVersion
Versi utama aplikasi penulis. Untuk informasi lebih lanjut, lihat bagian Keterangan.
[in] dwMinorVersion
Versi minor aplikasi penulis. Untuk informasi lebih lanjut, lihat bagian Keterangan.
[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 Bekukan .
Nilai default untuk parameter ini adalah VSS_APP_FRONT_END.
[in] dwTimeoutFreeze
Waktu maksimum yang diizinkan, dalam milidetik, antara penerimaan penulis dari pemberitahuan peristiwa Freeze dan penerimaannya atas pemberitahuan peristiwa Thaw yang cocok dari VSS. Setelah waktu habis berakhir, metode 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. Pemanggil 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 sebaliknya.
Nilai default untuk parameter ini adalah false. Pemanggil 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 informasi selengkapnya, lihat bagian Keterangan berikut ini.
Mengembalikan nilai
Berikut ini adalah kode pengembalian yang valid untuk metode ini.
| Nilai | Makna |
|---|---|
|
Objek penulis berhasil diinisialisasi. |
|
Objek penulis tidak dapat diinisialisasi; infrastruktur penulis VSS tidak aktif karena Windows dalam mode aman atau sedang disiapkan. |
|
Penelepon bukan administrator. |
|
Salah satu nilai parameter tidak valid. |
|
Pemanggil kehabisan memori atau sumber daya sistem lainnya. |
|
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
Metode InitializeEx identik dengan metode Inisialisasi kecuali untuk parameter dwMajorVersion dan dwMinorVersion . Jika penulis menggunakan Inisialisasi alih-alih InitializeEx, versi penulis akan dilaporkan sebagai 0.0 (versi utama = 0, versi minor = 0) oleh metode IVssExamineWriterMetadataEx2::GetVersion .
Parameter dwMajorVersion dan dwMinorVersion digunakan untuk menentukan nomor versi utama dan minor penulis sesuai dengan konvensi VSS berikut:
- Jika penulis telah berubah sejak Windows XP atau baru untuk Windows Vista, penulis harus menentukan 1.0 atau lebih tinggi untuk nomor versinya.
- Nomor versi minor penulis harus bertambah satu per satu setiap kali versi penulis yang dirilis berisi perubahan kecil yang memengaruhi interaksi penulis dengan pemohon. Misalnya, koreksi pada spesifikasi file dalam QFE penulis atau paket layanan akan membenarkan kenaikan nomor versi minor. Namun, perubahan antara versi beta atau kandidat rilis penulis tidak akan membenarkan perubahan nomor versi minor.
- Nomor versi utama penulis harus bertambah satu per satu setiap kali versi penulis yang dirilis berisi perubahan yang signifikan. Misalnya, jika data yang dicadangkan dengan versi baru penulis tidak dapat dipulihkan menggunakan versi penulis sebelumnya, nomor versi utama penulis baru harus bertahap.
- Setiap kali nomor versi utama bertahap, nomor versi minor harus diatur ulang ke nol.
VSS menetapkan ID instans penulis unik ke 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
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | vswriter.h (termasuk Vss.h, VsWriter.h) |
| Pustaka | VssApi.lib |