Bagikan melalui

Metode IVssComponent::GetRestoreSubcomponent (vswriter.h)

  • Artikel

Metode GetRestoreSubcomponent mengembalikan subkomponen yang ditentukan yang terkait dengan komponen tertentu.

Penulis atau pemohon dapat memanggil metode ini.

Sintaks

HRESULT GetRestoreSubcomponent(
  [in]  UINT iComponent,
  [out] BSTR *pbstrLogicalPath,
  [out] BSTR *pbstrComponentName,
  [out] bool *pbRepair
);

Parameter

[in] iComponent

Indeks subkomponen. Nilai parameter ini adalah bilangan bulat dari 0 hingga n–1 inklusif, di mana n adalah jumlah total subkomponen yang terkait dengan komponen tertentu. Nilai n dikembalikan oleh IVssComponent::GetRestoreSubcomponentCount.

[out] pbstrLogicalPath

Penunjuk ke string yang berisi jalur logis subkomponen. Jalur logika tidak boleh kosong saat bekerja dengan subkomponen.

[out] pbstrComponentName

Penunjuk ke string yang berisi nama subkomponen. String tidak boleh kosong.

[out] pbRepair

Disiapkan untuk penggunaan masa mendatang.

Mengembalikan nilai

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

Pemanggil harus membebaskan memori yang dipegang oleh parameter pbstrLogicalPath dan pbstrComponentName dengan memanggil SysFreeString.

Persyaratan

   
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