IVssExpressWriter::Metode CreateMetadata (vswriter.h)

Artikel
03/08/2023

Membuat objek metadata penulis ekspres dan mengembalikan penunjuk antarmuka IVssCreateExpressWriterMetadata ke objek tersebut.

Sintaks

HRESULT CreateMetadata(
  [in]  VSS_ID                          writerId,
  [in]  LPCWSTR                         writerName,
  [in]  VSS_USAGE_TYPE                  usageType,
  [in]  DWORD                           versionMajor,
  [in]  DWORD                           versionMinor,
  [in]  DWORD                           reserved,
  [out] IVssCreateExpressWriterMetadata **ppMetadata
);

Parameter

[in] writerId

Pengidentifikasi unik global (GUID) dari kelas penulis.

[in] writerName

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

[in] usageType

Nilai enumerasi VSS_USAGE_TYPE yang menunjukkan bagaimana data yang dikelola oleh penulis digunakan pada sistem host. Satu-satunya nilai yang valid untuk parameter ini adalah VSS_UT_BOOTABLESYSTEMSTATE, VSS_UT_SYSTEMSERVICE, dan VSS_UT_USERDATA.

[in] versionMajor

Versi utama aplikasi penulis. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in] versionMinor

Versi minor aplikasi penulis. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in] reserved

Parameter ini disediakan untuk penggunaan sistem.

[out] ppMetadata

Penunjuk ke variabel yang menerima penunjuk antarmuka IVssCreateExpressWriterMetadata ke metadata penulis ekspres yang baru dibuat.

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Parameter versionMajor dan versionMajor digunakan untuk menentukan nomor versi utama dan minor penulis sesuai dengan konvensi VSS berikut:

Nomor versi minor penulis harus bertambah satu kali 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.

Jika penulis tidak menentukan nomor versi, VSS akan menetapkan nomor versi default 0.0.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	vswriter.h

Lihat juga

CreateVssExpressWriter

IVssExpressWriter

Bagikan melalui