Fungsi RmGetList (restartmanager.h)

Artikel
08/25/2023

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

Sintaks

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 terdaftar di sesi.

[out] lpdwRebootReasons

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

Menampilkan nilai

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_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 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_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.

Persyaratan


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

RmCancelCurrentTask

Bagikan melalui