FwpmProviderContextAdd3-Funktion (fwpmu.h)

Artikel
05/03/2024

Fügt dem System einen neuen Anbieterkontext hinzu.

Syntax

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

Parameter

engineHandle

Typ: _In_ HANDLE

Ein Handle für eine geöffnete Sitzung mit der Filter-Engine. Um eine Sitzung mit der Filter-Engine zu öffnen, rufen Sie FwpmEngineOpen0 auf.

providerContext

Typ: _In_ FWPM_PROVIDER_CONTEXT3*

Das hinzuzufügende Anbieterkontextobjekt.

sd

Typ: _In_opt_ PSECURITY_DESCRIPTOR

Optionale Sicherheitsinformationen, die dem Anbieterkontextobjekt zugeordnet sind.

id

Typ: _Out_opt_ UINT64*

Zeiger auf eine Variable, die einen Laufzeitbezeichner für diesen Anbieterkontext empfängt.

Rückgabewert

Typ: DWORD*

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der Anbieterkontext wurde erfolgreich hinzugefügt.
ERROR_NOT_SUPPORTED 0x32	Die FWPM_IPSEC_IKE_MM_CONTEXT und die IKEEXT_IPV6_CGA Authentifizierungsmethode befinden sich im AuthenticationMethods-Array , aber kryptografisch generierte Adresse (CGA) ist in der Registrierung nicht aktiviert.
FWP_E_*-Fehlercode 0x80320001 – 0x80320039	Ein WFP-spezifischer Fehler (Windows Filtering Platform). Weitere Informationen finden Sie unter WFP-Fehlercodes.
RPC_*-Fehlercode 0x80010001 – 0x80010122	Fehler bei der Kommunikation mit der Remote- oder lokalen Firewall-Engine.

Hinweise

Einige Felder in der FWPM_PROVIDER_CONTEXT2-Struktur werden vom System und nicht vom Aufrufer zugewiesen und beim Aufruf von FwpmProviderContextAdd3 ignoriert.

Wenn Sie einen NULL-Sicherheitsdeskriptor angeben, weist das System einen Standardsicherheitsdeskriptor zu.

Sie können diese Funktion nicht innerhalb einer schreibgeschützten Transaktion aufrufen. Bei FWP_E_INCOMPATIBLE_TXN tritt ein Fehler auf. Weitere Informationen zu Transaktionen finden Sie unter Objektverwaltung.

Um diese Funktion aufzurufen, benötigen Sie FWPM_ACTRL_ADD Zugriff auf den Container des Anbieterkontexts und FWPM_ACTRL_ADD_LINK Zugriff auf den Anbieter (falls vorhanden). Weitere Informationen finden Sie unter Zugriffssteuerung.

Anforderungen

Anforderung	Wert
Header	fwpmu.h
Bibliothek	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Freigeben über