Fungsi RmJoinSession (restartmanager.h)

Artikel
03/15/2023

Menggabungkan alat penginstal sekunder ke sesi Restart Manager yang ada. Fungsi ini harus dipanggil dengan kunci sesi yang hanya dapat diperoleh dari penginstal utama yang memulai sesi. Kunci sesi yang valid diperlukan untuk menggunakan salah satu fungsi Restart Manager. Setelah penginstal sekunder bergabung dengan sesi, alat ini dapat memanggil fungsi RmRegisterResources untuk mendaftarkan sumber daya.

Sintaks

DWORD RmJoinSession(
  [out] DWORD          *pSessionHandle,
  [in]  const WCHAR [] strSessionKey
);

Parameter

[out] pSessionHandle

Penunjuk ke handel Sesi Restart Manager yang ada.

[in] strSessionKey

String yang dihentikan null yang berisi kunci sesi dari sesi yang ada.

Nilai kembali

Ini adalah kesalahan terbaru yang diterima. Fungsi ini dapat mengembalikan salah satu kode kesalahan sistem yang ditentukan dalam Winerror.h.

Nilai	Makna
ERROR_SUCCESS 0	Fungsi berhasil diselesaikan.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	Kunci sesi tidak dapat divalidasi.
ERROR_SEM_TIMEOUT 121	Fungsi Restart Manager tidak dapat memperoleh mutex tulis Registri dalam waktu yang dialokasikan. Sistem disarankan untuk memulai ulang karena penggunaan Restart Manager lebih lanjut kemungkinan akan gagal.
ERROR_BAD_ARGUMENTS 22	Satu atau beberapa argumen tidak benar. Nilai kesalahan ini dikembalikan oleh fungsi Restart Manager jika pointer NULL atau 0 diteruskan dalam parameter yang memerlukan nilai non-null dan bukan nol.
ERROR_WRITE_FAULT 29	Operasi tidak dapat membaca atau menulis ke registri.
ERROR_MAX_SESSIONS_REACHED 353	Jumlah maksimum sesi telah tercapai.
ERROR_OUTOFMEMORY 14	Operasi Restart Manager tidak dapat diselesaikan karena memori tidak cukup tersedia.

Keterangan

Fungsi RmJoinSession menggabungkan alat penginstal sekunder ke sesi Restart Manager yang ada. Ini biasanya merupakan alat penginstal yang tidak mengontrol antarmuka pengguna dan dapat menjalankan penginstal utama dalam proses atau di luar proses. Hanya alat penginstal utama yang dapat memanggil fungsi RmStartSession dan ini biasanya adalah aplikasi yang mengontrol antarmuka pengguna atau yang mengontrol urutan penginstalan beberapa patch dalam pembaruan.

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	restartmanager.h
Pustaka	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Lihat juga

RmEndSession

RmStartSession

Bagikan melalui