Fungsi RmGetList (restartmanager.h)

Mendapatkan daftar semua aplikasi dan layanan yang saat ini menggunakan sumber daya yang telah didaftarkan dengan sesi Restart Manager.

Sintaksis

DWORD RmGetList(
  [in]                DWORD              dwSessionHandle,
  [out]               UINT               *pnProcInfoNeeded,
  [in, out]           UINT               *pnProcInfo,
  [in, out, optional] RM_PROCESS_INFO [] rgAffectedApps,
  [out]               LPDWORD            lpdwRebootReasons
);

Parameter

[in] dwSessionHandle

Handel ke sesi Restart Manager yang ada.

[out] pnProcInfoNeeded

Penunjuk ke ukuran array yang diperlukan untuk menerima struktur RM_PROCESS_INFO yang diperlukan untuk mengembalikan informasi untuk semua aplikasi dan layanan yang terpengaruh.

[in, out] pnProcInfo

Penunjuk ke jumlah total struktur RM_PROCESS_INFO dalam array dan jumlah struktur yang diisi.

[in, out, optional] rgAffectedApps

Array struktur RM_PROCESS_INFO yang mencantumkan aplikasi dan layanan menggunakan sumber daya yang telah didaftarkan dengan sesi.

[out] lpdwRebootReasons

Penunjuk ke lokasi yang menerima nilai enumerasi RM_REBOOT_REASON yang menjelaskan alasan sistem memulai ulang diperlukan.

Mengembalikan nilai

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

Nilai Arti
ERROR_SUCCESS
0
 Fungsi berhasil diselesaikan.
ERROR_MORE_DATA
234
 Nilai kesalahan ini dikembalikan oleh fungsi RmGetList jika buffer rgAffectedApps terlalu kecil untuk menyimpan semua informasi aplikasi dalam daftar.
ERROR_CANCELLED
1223
 Operasi saat ini dibatalkan oleh pengguna.
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
160
 Satu atau beberapa argumen tidak benar. Nilai kesalahan ini dikembalikan oleh fungsi Restart Manager jika null pointer 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_OUTOFMEMORY
14
 Operasi Restart Manager tidak dapat diselesaikan karena memori tidak cukup tersedia.
ERROR_INVALID_HANDLE
6
 Tidak ada sesi Restart Manager untuk handel yang disediakan.
ERROR_ACCESS_DENIED
5
 Jalur yang terdaftar ke sesi Restart Manager adalah direktori.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Platform Target Windows
Header restartmanager.h
Pustaka Rstrtmgr.lib
DLL Rstrtmgr.dll

Lihat juga

RmCancelCurrentTask

  • Last updated on