FwpmProviderAdd0-Funktion (fwpmu.h)

Artikel
08/23/2023

Die Funktion FwpmProviderAdd0 fügt dem System einen neuen Anbieter hinzu.

Syntax

DWORD FwpmProviderAdd0(
  [in]           HANDLE               engineHandle,
  [in]           const FWPM_PROVIDER0 *provider,
  [in, optional] PSECURITY_DESCRIPTOR sd
);

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] provider

Typ: FWPM_PROVIDER0*

Das hinzuzufügende Anbieterobjekt.

[in, optional] sd

Typ: PSECURITY_DESCRIPTOR

Sicherheitsinformationen für das Anbieterobjekt.

Rückgabewert

Art: DWORD

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der Anbieter wurde erfolgreich hinzugefügt.
*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

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

Startzeitobjekte werden der Basisfilter-Engine (BFE) hinzugefügt, wenn der TCP/IP-Treiber gestartet wird, und werden entfernt, sobald die BFE-Initialisierung abgeschlossen ist. Persistente Objekte werden hinzugefügt, wenn die BFE gestartet wird. Wenn ein Richtlinienanbieter über eine persistente Richtlinie verfügt, die nicht erzwungen werden soll, wenn der zugehörige Dienst deaktiviert ist, kann der Aufrufer einen optionalen Dienstnamen in der FWPM_PROVIDER0-Struktur angeben. Dieser Dienst besitzt dann das persistente Richtlinienobjekt. Zu Beginn fügt die BFE dem System nur die folgenden Typen persistenter Objekte hinzu.

Das Objekt ist keinem Anbieter zugeordnet.
Das Objekt verfügt über einen zugeordneten Anbieter, der keinen Dienstnamen angibt.
Das Objekt verfügt über einen zugeordneten Anbieter und einen zugeordneten Dienst, der auf automatischen Start festgelegt ist.

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 Anbieters. Weitere Informationen finden Sie unter Access Control.

FwpmProviderAdd0 ist eine spezifische Implementierung von FwpmProviderAdd. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .

Anforderungen

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

Weitere Informationen

FWPM_PROVIDER0

Freigeben über