Función FwpmSubLayerSubscribeChanges0 (fwpmu.h)
La función FwpmSubLayerSubscribeChanges0 se usa para solicitar la entrega de notificaciones con respecto a los cambios en una subcapa determinada.
Sintaxis
DWORD FwpmSubLayerSubscribeChanges0(
[in] HANDLE engineHandle,
[in] const FWPM_SUBLAYER_SUBSCRIPTION0 *subscription,
[in] FWPM_SUBLAYER_CHANGE_CALLBACK0 callback,
[in, optional] void *context,
[out] HANDLE *changeHandle
);
Parámetros
[in] engineHandle
Tipo: HANDLE
Identificador de una sesión abierta en el motor de filtro. Llame a FwpmEngineOpen0 para abrir una sesión en el motor de filtro.
[in] subscription
Tipo: FWPM_SUBLAYER_SUBSCRIPTION0*
Las notificaciones que se van a entregar.
[in] callback
Tipo: FWPM_SUBLAYER_CHANGE_CALLBACK0
Puntero de función que se invocará cuando una notificación esté lista para su entrega.
[in, optional] context
Tipo: void*
Puntero de contexto opcional. Este puntero se pasa a la función de devolución de llamada junto con los detalles del cambio.
[out] changeHandle
Tipo: HANDLE*
Controle la suscripción recién creada.
Valor devuelto
Tipo: DWORD
| Código o valor devuelto | Descripción |
|---|---|
|
La suscripción se creó correctamente. |
|
Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información. |
|
Error al comunicarse con el motor de firewall remoto o local. |
Comentarios
Los suscriptores no reciben notificaciones de los cambios realizados con el mismo identificador de sesión que se usa para suscribirse. Esto se debe a que los suscriptores solo necesitan ver los cambios realizados por otros usuarios, ya que ya saben qué cambios han realizado ellos mismos.
No se puede llamar a esta función desde dentro de una transacción. Se producirá un error con FWP_E_TXN_IN_PROGRESS. Consulte Administración de objetos para obtener más información sobre las transacciones.
El autor de la llamada necesita FWPM_ACTRL_SUBSCRIBE acceso al contenedor de la subcapa y FWPM_ACTRL_READ acceso a la subcapa. El suscriptor solo recibirá notificaciones para las subcapas a las que tiene acceso FWPM_ACTRL_READ . Consulte Access Control para obtener más información.
FwpmSubLayerSubscribeChanges0 es una implementación específica de FwpmSubLayerSubscribeChanges. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .
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 | fwpmu.h |
| Library | Fwpuclnt.lib |
| Archivo DLL | Fwpuclnt.dll |