Funzione IPsecSaContextSubscribe0 (fwpmu.h)

La funzione IPsecSaContextSubscribe0 viene usata per richiedere il recapito di notifiche relative a un contesto specifico dell'associazione di sicurezza IPsec.The IPsecSaContextSubscribe0 function is used to request the delivery of notifications regarding a particular IPsec security association (SA) context.

Sintassi

DWORD IPsecSaContextSubscribe0(
  [in]           HANDLE                               engineHandle,
  [in]           const IPSEC_SA_CONTEXT_SUBSCRIPTION0 *subscription,
  [in]           IPSEC_SA_CONTEXT_CALLBACK0           callback,
  [in, optional] void                                 *context,
  [out]          HANDLE                               *eventsHandle
);

Parametri

[in] engineHandle

Tipo: HANDLE

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] subscription

Tipo: const IPSEC_SA_CONTEXT_SUBSCRIPTION0*

Notifiche che verranno recapitate.

[in] callback

Tipo: IPSEC_SA_CONTEXT_CALLBACK0

Puntatore a funzione che verrà richiamato quando una notifica è pronta per il recapito.

[in, optional] context

Tipo: void*

Puntatore di contesto facoltativo. Questo puntatore viene passato alla funzione di callback insieme ai dettagli dell'evento.

[out] eventsHandle

Tipo: HANDLE*

Gestire la sottoscrizione appena creata.

Valore restituito

Tipo: DWORD

Commenti

Questa funzione non può essere chiamata dall'interno di una transazione. Avrà esito negativo con FWP_E_TXN_IN_PROGRESS. Per altre informazioni sulle transazioni, vedere Gestione oggetti.

Il chiamante deve FWPM_ACTRL_SUBSCRIBE l'accesso al contenitore del contesto SA IPsec.

Requisiti

Vedi anche

IPSEC_SA_CONTEXT_CALLBACK0

IPSEC_SA_CONTEXT_SUBSCRIPTION0