Fungsi RmStartSession (restartmanager.h)
Memulai sesi Restart Manager baru. Maksimal 64 sesi Restart Manager per sesi pengguna dapat dibuka pada sistem secara bersamaan. Ketika fungsi ini memulai sesi, fungsi ini mengembalikan handel sesi dan kunci sesi yang dapat digunakan dalam panggilan berikutnya ke Api Restart Manager.
Sintaks
DWORD RmStartSession(
[out] DWORD *pSessionHandle,
DWORD dwSessionFlags,
[out] WCHAR [] strSessionKey
);
Parameter
[out] pSessionHandle
Penunjuk ke handel sesi Restart Manager. Handel sesi dapat diteruskan dalam panggilan berikutnya ke API Restart Manager.
dwSessionFlags
Dicadangkan. Parameter ini harus 0.
[out] strSessionKey
String null-terminated yang berisi kunci sesi ke sesi baru. String harus dialokasikan sebelum memanggil fungsi RmStartSession .
Mengembalikan nilai
Ini adalah kesalahan terbaru yang diterima. Fungsi ini dapat mengembalikan salah satu kode kesalahan sistem yang didefinisikan dalam Winerror.h.
Nilai | Makna |
---|---|
|
Fungsi berhasil diselesaikan. |
|
Fungsi Restart Manager tidak dapat memperoleh mutex tulis Registri dalam waktu yang dialokasikan. Mulai ulang sistem disarankan karena penggunaan Restart Manager lebih lanjut kemungkinan akan gagal. |
|
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. |
|
Jumlah maksimum sesi telah tercapai. |
|
Sistem tidak dapat menulis ke perangkat yang ditentukan. |
|
Operasi Restart Manager tidak dapat diselesaikan karena memori tidak cukup tersedia. |
Keterangan
Fungsi RmStartSession mengembalikan kesalahan jika sesi dengan kunci sesi yang sama sudah ada.
Fungsi RmStartSession harus dipanggil oleh alat penginstal utama yang mengontrol antarmuka pengguna atau yang mengontrol urutan penginstalan beberapa patch dalam pembaruan.
Penginstal sekunder dapat bergabung dengan sesi Restart Manager yang ada dengan memanggil fungsi RmJoinSession dengan handel sesi dan kunci sesi yang dikembalikan dari panggilan fungsi RmStartSession dari penginstal utama.
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 |