Función RmGetFilterList (restartmanager.h)

  • Artículo

Listas las modificaciones para apagar y reiniciar las acciones que ya ha aplicado la función RmAddFilter. La función devuelve un puntero a un búfer que contiene información sobre las modificaciones que se han aplicado.

Sintaxis

DWORD RmGetFilterList(
  [in]            DWORD   dwSessionHandle,
  [out, optional] PBYTE   pbFilterBuf,
  [in]            DWORD   cbFilterBuf,
  [out]           LPDWORD cbFilterBufNeeded
);

Parámetros

[in] dwSessionHandle

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

[out, optional] pbFilterBuf

Puntero a un búfer que contiene información de modificación.

[in] cbFilterBuf

Tamaño del búfer que contiene información de modificación en bytes.

[out] cbFilterBufNeeded

Número de bytes necesarios en el búfer.

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_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 como parámetro que requiere un valor distinto de NULL y distinto de cero.
ERROR_MORE_DATA
234
 La función RmGetFilterList devuelve este valor de error si el búfer pbFilterBuf es demasiado pequeño para contener toda la información de la aplicación en la lista o si no se especificó cbFilterBufNeeded .
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 Este error se devuelve cuando un instalador secundario llama a esta función. Esta función solo está disponible para los instaladores principales.

Comentarios

El búfer pbFilterBuf devuelto debe estar escrito en RM_FILTER_INFO para acceder a la lista de filtros.

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

Consulte también

RmAddFilter