Metode ICOMAdminCatalog2::D umpApplicationInstance (comadmin.h)

Membuat file cadangan yang berisi gambar status instans aplikasi yang ditentukan (proses).

Catatan Pada Windows Server 2003, hanya administrator yang memiliki hak akses baca ke file cadangan COM+.

 

Sintaks

HRESULT DumpApplicationInstance(
  [in]          BSTR bstrApplicationInstanceID,
  [in]          BSTR bstrDirectory,
  [in]          long lMaxImages,
  [out, retval] BSTR *pbstrDumpFile
);

Parameter

[in] bstrApplicationInstanceID

GUID instans aplikasi.

[in] bstrDirectory

Jalur lengkap ke direktori tempat file cadangan ditempatkan. Jangan sertakan nama file. Jika parameter ini NULL, direktori defaultnya adalah %SystemRoot%\system32\com\dmp.

[in] lMaxImages

Jumlah maksimum file cadangan yang mungkin ada di direktori cadangan. Menentukan variabel ini mencegah file cadangan mengkonsumsi terlalu banyak ruang penyimpanan.

[out, retval] pbstrDumpFile

Nama file cadangan yang berisi gambar instans aplikasi yang dihasilkan.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, dan E_FAIL, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
COMADMIN_E_APP_NOT_RUNNING	Proses yang ditentukan tidak berjalan.

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	comadmin.h

Lihat juga

ICOMAdminCatalog2