RmRegisterResources, fonction (restartmanager.h)

Article
03/01/2024

Inscrit des ressources dans une session Restart Manager. Le Gestionnaire de redémarrage utilise la liste des ressources inscrites auprès de la session pour déterminer quelles applications et services doivent être arrêtés et redémarrés. Les ressources peuvent être identifiées par des noms de fichiers, des noms courts de service ou des structures RM_UNIQUE_PROCESS qui décrivent des applications en cours d’exécution. La fonction RmRegisterResources peut être utilisée par un programme d’installation principal ou secondaire.

Syntaxe

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
);

Paramètres

[in] dwSessionHandle

Handle d’une session restart Manager existante.

[in] nFiles

Nombre de fichiers inscrits.

[in, optional] rgsFileNames

Tableau de chaînes terminées par null de chemins de nom de fichier complets. Ce paramètre peut avoir la valeur NULL si nFiles a la valeur 0.

[in] nApplications

Nombre de processus inscrits.

[in, optional] rgApplications

Tableau de structures RM_UNIQUE_PROCESS . Ce paramètre peut avoir la valeur NULL si nApplications est 0.

[in] nServices

Nombre de services à inscrire.

[in, optional] rgsServiceNames

Tableau de chaînes terminées par null de noms courts de service. Ce paramètre peut avoir la valeur NULL si nServices a la valeur 0.

Valeur retournée

Il s’agit de l’erreur la plus récente reçue. La fonction peut retourner l’un des codes d’erreur système définis dans Winerror.h.

Valeur	Signification
ERROR_SUCCESS 0	Les ressources spécifiées ont été inscrites.
ERROR_SEM_TIMEOUT 121	Une fonction Restart Manager n’a pas pu obtenir un mutex d’écriture du Registre dans le délai imparti. Un redémarrage du système est recommandé, car l’utilisation ultérieure du Gestionnaire de redémarrage risque d’échouer.
ERROR_BAD_ARGUMENTS 160	Un ou plusieurs arguments sont incorrects. Cette valeur d’erreur est retournée par la fonction Restart Manager si un pointeur NULL ou 0 est passé dans un paramètre qui nécessite une valeur non null et une valeur non nulle.
ERROR_WRITE_FAULT 29	Une opération n’a pas pu lire ou écrire dans le Registre.
ERROR_OUTOFMEMORY 14	Une opération du Gestionnaire de redémarrage n’a pas pu se terminer, car la mémoire disponible n’était pas suffisante.
ERROR_INVALID_HANDLE 6	Il n’existe aucune session Restart Manager pour le handle fourni.

Remarques

Chaque appel à la fonction RmRegisterResources effectue des opérations d’écriture relativement coûteuses. N’appelez pas cette fonction une seule fois par fichier, mais regroupez les fichiers associés dans des composants et inscrivez-les ensemble.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	restartmanager.h
Bibliothèque	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Partager via