Compartir a través de

Función RmRegisterResources (restartmanager.h)

Registra los recursos en una sesión del Administrador de reinicio. El Administrador de reinicio usa la lista de recursos registrados con la sesión para determinar qué aplicaciones y servicios deben apagarse y reiniciarse. Los recursos se pueden identificar mediante nombres de archivo, nombres cortos de servicio o estructuras de RM_UNIQUE_PROCESS que describen las aplicaciones en ejecución. Un instalador principal o secundario puede usar la función RmRegisterResources .

Sintaxis

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

Parámetros

[in] dwSessionHandle

Identificador de una sesión existente del Administrador de reinicio.

[in] nFiles

Número de archivos que se están registrando.

[in, optional] rgsFileNames

Matriz de cadenas terminadas en null de rutas de acceso de nombre de archivo completas. Este parámetro puede ser NULL si nFiles es 0.

[in] nApplications

Número de procesos que se registran.

[in, optional] rgApplications

Matriz de estructuras de RM_UNIQUE_PROCESS . Este parámetro puede ser NULL si nApplications es 0.

[in] nServices

Número de servicios que se van a registrar.

[in, optional] rgsServiceNames

Matriz de cadenas terminadas en null de nombres cortos de servicio. Este parámetro puede ser NULL si nServices es 0.

Valor devuelto

Este es el error más reciente recibido. La función puede devolver uno de los códigos de error del sistema definidos en Winerror.h.

Valor Significado
ERROR_SUCCESS
0
 Se han registrado los recursos especificados.
ERROR_SEM_TIMEOUT
121
 Una función Restart Manager no pudo obtener una exclusión mutua de escritura del Registro en el tiempo asignado. Se recomienda reiniciar el sistema porque es probable que se produzca un error en el uso posterior del Administrador de reinicios.
ERROR_BAD_ARGUMENTS
160
 Uno o más argumentos son incorrectos. La función Restart Manager devuelve este valor de error si se pasa un puntero NULL o 0 en un parámetro que requiere un valor distinto de NULL y distinto de cero.
ERROR_WRITE_FAULT
29
 Una operación no pudo leer o escribir en el Registro.
ERROR_OUTOFMEMORY
14
 No se pudo completar una operación del Administrador de reinicio porque no había suficiente memoria disponible.
ERROR_INVALID_HANDLE
6
 No existe ninguna sesión del Administrador de reinicio para el identificador proporcionado.

Comentarios

Cada llamada a la función RmRegisterResources realiza operaciones de escritura relativamente costosas. No llame a esta función una vez por archivo, en su lugar agrupe los archivos relacionados en componentes y registre estos juntos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado restartmanager.h
Library Rstrtmgr.lib
Archivo DLL Rstrtmgr.dll
  • Last updated on