Metode IVssExamineWriterMetadataEx::GetIdentityEx (vsbackup.h)

  • Artikel

Metode GetIdentityEx mendapatkan nama instans penulis dan informasi dasar lainnya tentang instans penulis tertentu.

Sintaks

HRESULT GetIdentityEx(
  [out] VSS_ID          *pidInstance,
  [out] VSS_ID          *pidWriter,
  [out] BSTR            *pbstrWriterName,
  [out] BSTR            *pbstrInstanceName,
  [out] VSS_USAGE_TYPE  *pUsage,
  [out] VSS_SOURCE_TYPE *pSource
);

Parameter

[out] pidInstance

Pengidentifikasi unik global (GUID) dari instans penulis.

[out] pidWriter

GUID kelas penulis.

[out] pbstrWriterName

Penunjuk ke string yang menentukan nama penulis.

[out] pbstrInstanceName

Penunjuk ke string yang menentukan nama instans penulis.

[out] pUsage

Penunjuk ke nilai enumerasi VSS_USAGE_TYPE yang menunjukkan bagaimana data yang dikelola oleh penulis digunakan pada sistem host.

[out] pSource

Penunjuk ke nilai enumerasi VSS_SOURCE_TYPE yang menunjukkan jenis data yang dikelola oleh penulis.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
 Berhasil mengembalikan informasi identitas.
E_INVALIDARG
 Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY
 Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_INVALID_XML_DOCUMENT
 Dokumen XML tidak valid. Periksa log peristiwa untuk detailnya. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
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

Metode ini identik dengan metode IVssExamineWriterMetadata::GetIdentity kecuali untuk parameter pbstrInstanceName .

Parameter pbstrInstanceName adalah nama instans penulis yang ditentukan selama inisialisasi penulis oleh CVssWriter::Initialize.

Nama instans penulis berguna untuk penulis yang mendukung menjalankan beberapa instans penulis dengan ID kelas penulis yang sama pada satu komputer. Nama instans penulis dapat digunakan untuk mengidentifikasi instans tertentu. Oleh karena itu, penulis harus membuat nama instans unik dalam kelas penulis. Selain itu, nama instans penulis diharapkan untuk bertahan antara pencadangan dan pemulihan, dan digunakan oleh VSS untuk memulihkan penulis beberapa instans dengan benar.

Pemanggil harus membebaskan memori yang dipegang oleh parameter pbstrWriterName dan pbstrInstanceName dengan memanggil SysFreeString.

Antarmuka IVssExamineWriterMetadataEx mungkin berasal dari informasi status penulis yang disimpan (dibuat oleh panggilan ke CreateVssExamineWriterMetadata). Jika demikian, maka berikut ini benar:

  • pidInstance mungkin tidak berarti apa-apa dalam hal penulis langsung.
  • Jika pidWriter tidak cocok dengan kelas penulis dari penulis langsung apa pun, pemohon tidak boleh menggunakan komponen penulis tersebut.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008, Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform Windows
Header vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h)
Pustaka VssApi.lib

Lihat juga

CVssWriter::Initialize

IVssExamineWriterMetadataEx