Función FwpmSystemPortsUnsubscribe0 (fwpmu.h)
La función FwpmSystemPortsUnsubscribe0 se usa para cancelar una suscripción de puerto del sistema y dejar de recibir notificaciones.
Sintaxis
DWORD FwpmSystemPortsUnsubscribe0(
[in, optional] HANDLE engineHandle,
[in, out] HANDLE sysPortsHandle
);
Parámetros
[in, optional] 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, out] sysPortsHandle
Tipo: HANDLE
Identificador de la notificación de puerto del sistema suscrito. Este es el identificador devuelto de la llamada a FwpmSystemPortsSubscribe0.
Valor devuelto
Tipo: DWORD
| Código o valor devuelto | Descripción |
|---|---|
|
La suscripción se eliminó 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
La cancelación de la suscripción con un identificador de objeto no válido dará como resultado un valor devuelto de ERROR_SUCCESS, pero la suscripción real se conservará hasta que se llame a la API de cancelación de suscripción con parámetros válidos.
Si la devolución de llamada se está invocando actualmente, esta función no devolverá hasta que se complete. Por lo tanto, al llamar a esta función, no debe contener ningún bloqueo que la devolución de llamada también pueda intentar adquirir el interbloqueo.
No es necesario cancelar la suscripción antes de cerrar una sesión; todas las suscripciones se cancelan automáticamente cuando finaliza la sesión de suscripción.
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.
FwpmSystemPortsUnsubscribe0 es una implementación específica de FwpmSystemPortsUnsubscribe. 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 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | fwpmu.h |
| Library | Fwpuclnt.lib |
| Archivo DLL | Fwpuclnt.dll |