IVssComponent::GetNewTarget method (vswriter.h)

  • Artikel

Metode GetNewTarget mengembalikan lokasi pemulihan file baru untuk komponen atau set komponen yang dipilih. (Lihat Bekerja dengan Jalur Pemilihan dan Logis untuk informasi tentang memilih komponen.)

Penulis atau pemohon dapat memanggil metode ini.

Sintaks

HRESULT GetNewTarget(
  [in]  UINT           iNewTarget,
  [out] IVssWMFiledesc **ppFiledesc
);

Parameter

[in] iNewTarget

Nomor indeks target baru. Nilai parameter ini adalah bilangan bulat dari 0 hingga n–1 inklusif, di mana n adalah jumlah total target baru yang terkait dengan komponen tertentu. Nilai n dikembalikan oleh IVssComponent::GetNewTargetCount.

[out] ppFiledesc

Dua arah tidak langsung ke objek IVssWMFiledesc yang berisi informasi lokasi pemulihan target baru.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
 Berhasil mengembalikan nilai atribut.
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_OBJECT_NOT_FOUND
 Item yang ditentukan tidak ditemukan.

Keterangan

Target baru yang dikembalikan oleh GetNewTarget mungkin bukan hanya file dalam komponen saat ini tetapi untuk file di salah satu subkomponen yang tidak dapat dipilih.

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 vswriter.h (termasuk Vss.h, VsWriter.h)
Pustaka VssApi.lib

Lihat juga

IVssComponent

IVssComponent::GetNewTargetCount