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.
Ruft einen Anbieterkontext ab.
Syntax
DWORD FwpmProviderContextGetByKey3(
HANDLE engineHandle,
const GUID *key,
FWPM_PROVIDER_CONTEXT3 **providerContext
);
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.
key
Typ: _In_ const GUID*
Zeiger auf eine GUID , die den Anbieterkontext eindeutig identifiziert. Dies ist ein Zeiger auf dieselbe GUID , die angegeben wurde, als Ihre Anwendung FwpmProviderContextAdd3 für dieses Objekt aufgerufen hat.
providerContext
Typ: _Outptr_ FWPM_PROVIDER_CONTEXT3**
Die Anbieterkontextinformationen.
Rückgabewert
Typ: DWORD*
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
| ERROR_SUCCESS 0 |
Der Anbieterkontext wurde erfolgreich abgerufen. |
| 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
Sie müssen das zurückgegebene Objekt freigeben, indem Sie FwpmFreeMemory0 aufrufen.
Um diese Funktion aufzurufen, benötigen Sie FWPM_ACTRL_READ Zugriff auf den Anbieterkontext. Weitere Informationen finden Sie unter Zugriffssteuerung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | fwpmu.h |
| Bibliothek | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |