FwpmProviderAdd0-Funktion (fwpmk.h)

  • Artikel

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

Syntax

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

Parameter

[in] engineHandle

Behandeln einer geöffneten Sitzung für das Filtermodul. Rufen Sie FwpmEngineOpen0- auf, um eine Sitzung für das Filtermodul zu öffnen.

[in] provider

Das hinzuzufügende Anbieterobjekt.

[in, optional] sd

Sicherheitsinformationen für das Anbieterobjekt.

Rückgabewert

Zurückgeben von Code/Wert Beschreibung
ERROR_SUCCESS
0		 Der Anbieter wurde erfolgreich hinzugefügt.
FWP_E_* Fehlercode
0x80320001 – 0x80320039		 Ein WFP-spezifischer Fehler (Windows-Filterplattform). Weitere Informationen finden Sie unter WFP-Fehlercodes.
RPC_*-Fehlercode
0x80010001 – 0x80010122		 Fehler bei der Kommunikation mit dem Remote- oder lokalen Firewallmodul.
Andere NTSTATUS-Codes Fehler.

Bemerkungen

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

Startzeitobjekte werden dem Basisfiltermodul (Base Filtering Engine, BFE) hinzugefügt, wenn der TCP/IP-Treiber gestartet wird, und werden entfernt, sobald die BFE die Initialisierung abgeschlossen hat. Persistente Objekte werden hinzugefügt, wenn das 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. Zunächst fügt das BFE nur die folgenden Typen persistenter Objekte zum System 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 den automatischen Start festgelegt ist.

Diese Funktion kann nicht innerhalb einer schreibgeschützten Transaktion aufgerufen werden, sie schlägt mit FWP_E_INCOMPATIBLE_TXNfehl. 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 Zugriffssteuerungs-.

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar ab Windows Vista.
Zielplattform- Universal
Header- fwpmk.h
Library fwpkclnt.lib
IRQL- <= PASSIVE_LEVEL

Siehe auch