Función RmGetList (restartmanager.h)

  • Artículo

Obtiene una lista de todas las aplicaciones y servicios que actualmente usan recursos que se han registrado con la sesión del Administrador de reinicio.

Sintaxis

DWORD RmGetList(
  [in]                DWORD              dwSessionHandle,
  [out]               UINT               *pnProcInfoNeeded,
  [in, out]           UINT               *pnProcInfo,
  [in, out, optional] RM_PROCESS_INFO [] rgAffectedApps,
  [out]               LPDWORD            lpdwRebootReasons
);

Parámetros

[in] dwSessionHandle

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

[out] pnProcInfoNeeded

Puntero a un tamaño de matriz necesario para recibir RM_PROCESS_INFO estructuras necesarias para devolver información para todas las aplicaciones y servicios afectados.

[in, out] pnProcInfo

Puntero al número total de estructuras de RM_PROCESS_INFO en una matriz y número de estructuras rellenadas.

[in, out, optional] rgAffectedApps

Matriz de estructuras de RM_PROCESS_INFO que enumeran las aplicaciones y los servicios mediante recursos que se han registrado en la sesión.

[out] lpdwRebootReasons

Puntero a la ubicación que recibe un valor de la enumeración RM_REBOOT_REASON que describe el motivo por el que se necesita un reinicio del sistema.

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
 Si se devuelve este valor, significa que la función se completó correctamente.
ERROR_MORE_DATA
234
 La función RmGetList devuelve este valor de error si el búfer rgAffectedApps es demasiado pequeño para contener toda la información de la aplicación en la lista.
ERROR_CANCELLED
1223
 El usuario cancela la operación actual.
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 adicional 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.

Requisitos

   
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

Consulte también

RmCancelCurrentTask