Funzione FwpmProviderContextAdd3 (fwpmu.h)

Aggiunge un nuovo contesto del provider al sistema.

Sintassi

DWORD FwpmProviderContextAdd3(
  HANDLE                       engineHandle,
  const FWPM_PROVIDER_CONTEXT3 *providerContext,
  PSECURITY_DESCRIPTOR         sd,
  UINT64                       *id
);

Parametri

engineHandle

Tipo: _In_ HANDLE

Handle per una sessione aperta con il motore di filtro. Per aprire una sessione con il motore di filtro, chiamare FwpmEngineOpen0.

providerContext

Tipo: _In_ FWPM_PROVIDER_CONTEXT3*

Oggetto contesto del provider da aggiungere.

sd

Tipo: _In_opt_ PSECURITY_DESCRIPTOR

Informazioni di sicurezza facoltative associate all'oggetto contesto del provider.

id

Tipo: _Out_opt_ UINT64*

Puntatore a una variabile che riceve un identificatore di runtime per questo contesto del provider.

Valore restituito

Tipo: DWORD*

Commenti

Alcuni campi nella struttura FWPM_PROVIDER_CONTEXT2 vengono assegnati dal sistema, non dal chiamante e vengono ignorati nella chiamata a FwpmProviderContextAdd3.

Se si specifica un descrittore di sicurezza NULL , il sistema assegna un descrittore di sicurezza predefinito.

Non è possibile chiamare questa funzione all'interno di una transazione di sola lettura. Avrà esito negativo con FWP_E_INCOMPATIBLE_TXN. Per altre informazioni sulle transazioni, vedere Gestione oggetti.

Per chiamare questa funzione, è necessario FWPM_ACTRL_ADD l'accesso al contenitore del contesto del provider e FWPM_ACTRL_ADD_LINK l'accesso al provider (se presente). Per altre informazioni, vedere Controllo di accesso.

Requisiti