Compartir a través de

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 reinicios.

[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 RM_PROCESS_INFO estructuras 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
 La función se completó correctamente.
ERROR_MORE_DATA
234
 El RmGetList devuelve este valor de error si el búfer de rgAffectedApps es demasiado pequeño para contener toda la información de la aplicación de 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 varios argumentos no son correctos. La función Restart Manager devuelve este valor de error si se pasa un puntero de NULL o 0 en un parámetro que requiere un valor nonull 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.
ERROR_ACCESS_DENIED
5
 Una ruta de acceso registrada en la sesión del Administrador de reinicio es un directorio.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de restartmanager.h
biblioteca de Rstrtmgr.lib
DLL de Rstrtmgr.dll

Consulte también

RmCancelCurrentTask