Metode IVssExamineWriterMetadata::GetIdentity (vsbackup.h)

Artikel
03/03/2024

Metode GetIdentity mendapatkan informasi dasar tentang instans penulis tertentu.

Sintaks

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

Parameter

[out] pidInstance

Alamat variabel yang dialokasikan pemanggil yang menerima pengidentifikasi instans penulis.

[out] pidWriter

Alamat variabel yang dialokasikan pemanggil yang menerima pengidentifikasi kelas penulis.

[out] pbstrWriterName

Alamat variabel yang dialokasikan pemanggil yang menerima string yang berisi nama penulis.

[out] pUsage

Alamat variabel yang dialokasikan pemanggil yang menerima nilai enumerasi VSS_USAGE_TYPE yang menentukan bagaimana data yang dikelola oleh penulis digunakan pada sistem host.

[out] pSource

Alamat variabel yang dialokasikan pemanggil yang menerima nilai enumerasi VSS_SOURCE_TYPE yang menentukan 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

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

Antarmuka IVssExamineWriterMetadata mungkin berasal dari informasi status penulis tersimpan (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 mana pun, pemohon tidak boleh menggunakan komponen penulis tersebut.

Persyaratan

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

Lihat juga

CreateVssExamineWriterMetadata

IVssExamineWriterMetadata

VSS_SOURCE_TYPE

VSS_USAGE_TYPE

Bagikan melalui