Función FwpsvSwitchEventsSubscribe0 (fwpsk.h)
La función FwpsvSwitchEventsSubscribe0 registra puntos de entrada de devolución de llamada para eventos de capa de conmutador virtual, como la creación y eliminación de puertos virtuales.
Sintaxis
NTSTATUS FwpsvSwitchEventsSubscribe0(
const GUID *providerGuid,
void *notifyContext,
UINT32 flags,
void *reserved,
const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
UINT32 *subscriptionId
);
Parámetros
providerGuid
Guid del proveedor.
notifyContext
Puntero opcional a un contexto proporcionado por el controlador de llamada. Las funciones de notificación de eventos vuelven a pasar este parámetro al controlador.
flags
Reservado. Establézcalo en cero.
reserved
Reservado. Establézcalo en cero.
eventDispatchTable
Puntero a una estructura FWPS_VSWITCH_EVENT_DISPATCH_TABLE que define los puntos de entrada de devolución de llamada para eventos de capa de conmutador virtual.
subscriptionId
Puntero a una variable que contiene un identificador único que el PMA asigna a la suscripción. El autor de la llamada debe devolver el identificador de suscripción al PMA con la función FwpsvSwitchEventsUnsubscribe0.
Valor devuelto
La función FwpsvSwitchEventsSubscribe0 devuelve uno de los siguientes códigos NTSTATUS.
| Código devuelto | Descripción |
|---|---|
|
Se devolvió correctamente un identificador a la solicitud de clasificación. Variable a la que apunta el parámetro classifyHandle contiene el identificador de la solicitud de clasificación. |
|
Error. |
Observaciones
Un controlador de llamada llama a la función FwpsvSwitchEventsSubscribe0 para registrar puntos de entrada de devolución de llamada para eventos de capa de conmutador virtual.
Los puntos de entrada de las funciones de notificación de devolución de llamada se especifican en y FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 estructura.
El controlador de llamada debe llamar posteriormente a FwpsvSwitchEventsUnsubscribe0 para liberar los recursos del sistema.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 8. |
| de la plataforma de destino de | Universal |
| encabezado de | fwpsk.h (incluya Fwpsk.h) |
| biblioteca de | Fwpkclnt.lib |
| irQL | <= PASSIVE_LEVEL |