Fungsi RmRegisterResources (restartmanager.h)

Artikel
03/15/2023

Mendaftarkan sumber daya ke sesi Restart Manager. Restart Manager menggunakan daftar sumber daya yang terdaftar dengan sesi untuk menentukan aplikasi dan layanan mana yang harus dimatikan dan dimulai ulang. Sumber daya dapat diidentifikasi dengan nama file, nama pendek layanan, atau struktur RM_UNIQUE_PROCESS yang menjelaskan aplikasi yang sedang berjalan. Fungsi RmRegisterResources dapat digunakan oleh penginstal primer atau sekunder.

Sintaks

DWORD RmRegisterResources(
  [in]           DWORD                dwSessionHandle,
  [in]           UINT                 nFiles,
  [in, optional] LPCWSTR []           rgsFileNames,
  [in]           UINT                 nApplications,
  [in, optional] RM_UNIQUE_PROCESS [] rgApplications,
  [in]           UINT                 nServices,
  [in, optional] LPCWSTR []           rgsServiceNames
);

Parameter

[in] dwSessionHandle

Handel ke sesi Restart Manager yang ada.

[in] nFiles

Jumlah file yang didaftarkan.

[in, optional] rgsFileNames

Array string jalur nama file lengkap yang dihentikan null. Parameter ini dapat berupa NULL jika nFiles adalah 0.

[in] nApplications

Jumlah proses yang didaftarkan.

[in, optional] rgApplications

Array struktur RM_UNIQUE_PROCESS . Parameter ini bisa NULL jika nApplications adalah 0.

[in] nServices

Jumlah layanan yang akan didaftarkan.

[in, optional] rgsServiceNames

Array string nama pendek layanan yang dihentikan null. Parameter ini bisa NULL jika nServices adalah 0.

Mengembalikan 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	Sumber daya yang ditentukan telah didaftarkan.
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.

Keterangan

Setiap panggilan ke fungsi RmRegisterResources melakukan operasi tulis yang relatif mahal. Jangan panggil fungsi ini sekali per file, sebagai gantinya kelompokkan file terkait bersama-sama ke dalam komponen dan daftarkan ini bersama-sama.

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

Bagikan melalui