FwpmProviderContextAdd2-Funktion (fwpmu.h)

Artikel
08/23/2023

Die Funktion FwpmProviderContextAdd2 fügt dem System einen neuen Anbieterkontext hinzu.

HinweisFwpmProviderContextAdd2 ist die spezifische Implementierung von FwpmProviderContextAdd, die in Windows 8 verwendet wird. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen . Für Windows 7 ist FwpmProviderContextAdd1 verfügbar. Für Windows Vista ist FwpmProviderContextAdd0 verfügbar.

Syntax

DWORD FwpmProviderContextAdd2(
  [in]            HANDLE                       engineHandle,
  [in]            const FWPM_PROVIDER_CONTEXT2 *providerContext,
  [in, optional]  PSECURITY_DESCRIPTOR         sd,
  [out, optional] UINT64                       *id
);

Parameter

[in] engineHandle

Typ: HANDLE

Handle für eine geöffnete Sitzung für die Filter-Engine. Rufen Sie FwpmEngineOpen0 auf, um eine Sitzung für die Filter-Engine zu öffnen.

[in] providerContext

Typ: FWPM_PROVIDER_CONTEXT2*

Das hinzuzufügende Anbieterkontextobjekt.

[in, optional] sd

Typ: PSECURITY_DESCRIPTOR

Sicherheitsinformationen, die dem Anbieterkontextobjekt zugeordnet sind.

[out, optional] id

Typ: UINT64*

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

Rückgabewert

Art: DWORD

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der Anbieterkontext wurde erfolgreich hinzugefügt.
ERROR_NOT_SUPPORTED 0x32	Die Authentifizierungsmethode [FWPM_IPSEC_IKE_MM_CONTEXT](/windows/desktop/api/fwpmtypes/ne-fwpmtypes-fwpm_provider_context_type) und [IKEEXT_IPV6_CGA](/windows/desktop/api/iketypes/ne-iketypes-ikeext_authentication_method_type) 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 FwpmProviderContextAdd2 ignoriert.

Wenn der Aufrufer einen NULL-Sicherheitsdeskriptor bereitstellt, weist das System einen Standardsicherheitsdeskriptor zu.

Diese Funktion kann nicht innerhalb einer schreibgeschützten Transaktion aufgerufen werden. Bei FWP_E_INCOMPATIBLE_TXN tritt ein Fehler auf. Weitere Informationen zu Transaktionen finden Sie unter Objektverwaltung .

Der Aufrufer benötigt 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 Access Control.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	fwpmu.h
Bibliothek	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Weitere Informationen

FWPM_PROVIDER_CONTEXT2

Freigeben über