Función FwpmCalloutGetById0 (fwpmk.h)
La función FwpmCalloutGetById0 recupera una llamada del motor de filtros mediante el identificador en tiempo de ejecución de la llamada.
Sintaxis
NTSTATUS FwpmCalloutGetById0(
[in] HANDLE engineHandle,
[in] UINT32 id,
[out] FWPM_CALLOUT0 **callout
);
Parámetros
[in] engineHandle
Identificador de una sesión abierta en el motor de filtro. Llame a función fwpmEngineOpen0 para abrir una sesión en el motor de filtro.
[in] id
Identificador en tiempo de ejecución de la llamada que se va a recuperar del motor de filtro. Debe ser el identificador en tiempo de ejecución que se devolvió cuando el controlador de llamada llamó a la función FwpmCalloutAdd0 para agregar la llamada al motor de filtro.
[out] callout
Información sobre el estado asociado a la llamada especificada por el id parámetro.
Valor devuelto
La función FwpmCalloutGetById0 devuelve uno de los siguientes códigos NTSTATUS.
| Código y valor devueltos | Descripción |
|---|---|
|
ERROR_SUCCESS 0 |
La llamada se recuperó correctamente. |
|
FWP_E_* de código de error 0x80320001: 0x80320039 |
Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información. |
|
RPC_* código de error 0x80010001: 0x80010122 |
Error al comunicarse con el motor de firewall remoto o local. |
| otros códigos NTSTATUS | Error. |
Observaciones
El autor de la llamada debe liberar el objeto devuelto por una llamada a FwpmFreeMemory0.
El autor de la llamada necesita FWPM_ACTRL_READ acceso a la llamada. Consulte access Control para obtener más información.
fwpmCalloutGetById0 es una implementación específica de FwpmCalloutGetById. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows Vista. |
| de la plataforma de destino de |
Universal |
| encabezado de |
fwpmk.h |
| biblioteca de |
fwpkclnt.lib |
| irQL | <= PASSIVE_LEVEL |