Funzione RmRegisterResources (restartmanager.h)

Articolo
03/05/2024

Registra le risorse in una sessione di Restart Manager. Gestione riavvio usa l'elenco delle risorse registrate nella sessione per determinare quali applicazioni e servizi devono essere arrestati e riavviati. Le risorse possono essere identificate da nomi file, nomi brevi del servizio o strutture RM_UNIQUE_PROCESS che descrivono le applicazioni in esecuzione. La funzione RmRegisterResources può essere usata da un programma di installazione primario o secondario.

Sintassi

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

Parametri

[in] dwSessionHandle

Handle per una sessione di Gestione riavvio esistente.

[in] nFiles

Numero di file registrati.

[in, optional] rgsFileNames

Matrice di stringhe con terminazione Null di percorsi di nome file completi. Questo parametro può essere NULL se nFiles è 0.

[in] nApplications

Numero di processi registrati.

[in, optional] rgApplications

Matrice di strutture RM_UNIQUE_PROCESS . Questo parametro può essere NULL se nApplications è 0.

[in] nServices

Numero di servizi da registrare.

[in, optional] rgsServiceNames

Matrice di stringhe con terminazione Null di nomi brevi del servizio. Questo parametro può essere NULL se nServices è 0.

Valore restituito

Questo è l'errore più recente ricevuto. La funzione può restituire uno dei codici di errore di sistema definiti in Winerror.h.

Valore	Significato
ERROR_SUCCESS 0	Le risorse specificate sono state registrate.
ERROR_SEM_TIMEOUT 121	Una funzione di Gestione riavvio non è in grado di ottenere un mutex di scrittura del Registro di sistema nel tempo assegnato. È consigliabile riavviare il sistema perché è probabile che l'uso di Gestione riavvio abbia esito negativo.
ERROR_BAD_ARGUMENTS 160	Uno o più argomenti non sono corretti. Questo valore di errore viene restituito dalla funzione Restart Manager se un puntatore NULL o 0 viene passato in un parametro che richiede un valore diverso da null e diverso da zero.
ERROR_WRITE_FAULT 29	Un'operazione non è riuscita a leggere o scrivere nel Registro di sistema.
ERROR_OUTOFMEMORY 14	Impossibile completare un'operazione di Gestione riavvio perché non era disponibile memoria sufficiente.
ERROR_INVALID_HANDLE 6	Non esiste alcuna sessione di Gestione riavvio per l'handle fornito.

Commenti

Ogni chiamata alla funzione RmRegisterResources esegue operazioni di scrittura relativamente costose. Non chiamare questa funzione una sola volta per ogni file, ma raggruppare i file correlati nei componenti e registrarle insieme.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	restartmanager.h
Libreria	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Condividi tramite