Bagikan melalui

Fungsi RmStartSession (restartmanager.h)

  • Artikel

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
ERROR_SUCCESS
0
 Fungsi berhasil diselesaikan.
ERROR_SEM_TIMEOUT
121
 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.
ERROR_BAD_ARGUMENTS
160
 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_MAX_SESSIONS_REACHED
353
 Jumlah maksimum sesi telah tercapai.
ERROR_WRITE_FAULT
29
 Sistem tidak dapat menulis ke perangkat yang ditentukan.
ERROR_OUTOFMEMORY
14
 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

Lihat juga

RmEndSession

RmJoinSession