Metode IVssComponentEx::GetRestoreName (vswriter.h)

Mendapatkan nama logis yang ditetapkan ke komponen yang sedang dipulihkan.

Sintaks

HRESULT GetRestoreName(
  [out] BSTR *pbstrName
);

Parameter

[out] pbstrName

Alamat variabel yang dialokasikan penelepon yang menerima string karakter lebar yang dihentikan null yang berisi nama pemulihan untuk komponen.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Operasi berhasil.
E_INVALIDARG	Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY	Pemanggil kehabisan memori atau sumber daya sistem lainnya.

Keterangan

Metode GetRestoreName hanya dapat dipanggil selama operasi pemulihan.

Jika panggilan ke GetRestoreName berhasil, pemanggil bertanggung jawab untuk membebaskan string yang dikembalikan dalam parameter pbstrName dengan memanggil fungsi SysFreeString .

Penulis menunjukkan bahwa ia mendukung metode ini dengan mengatur bendera VSS_BS_RESTORE_RENAME dalam masker skema cadangannya.

Untuk informasi selengkapnya, lihat Mengatur Opsi Pemulihan VSS.

Persyaratan

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

Lihat juga

IVssBackupComponentsEx2::SetRestoreName

IVssComponentEx

VSS_BACKUP_SCHEMA