FwpmProviderAdd0-Funktion (fwpmu.h)
Die Funktion FwpmProviderAdd0 fügt dem System einen neuen Anbieter hinzu.
DWORD FwpmProviderAdd0(
[in] HANDLE engineHandle,
[in] const FWPM_PROVIDER0 *provider,
[in, optional] PSECURITY_DESCRIPTOR sd
);
[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.
Art: DWORD
Rückgabecode/-wert | BESCHREIBUNG |
---|---|
|
Der Anbieter wurde erfolgreich hinzugefügt. |
|
Ein WFP-spezifischer Fehler (Windows Filtering Platform). Weitere Informationen finden Sie unter WFP-Fehlercodes . |
|
Fehler bei der Kommunikation mit der Remote- oder lokalen Firewall-Engine. |
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.
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 .
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 |