Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |