FwpmProviderContextGetByKey0-Funktion (fwpmk.h)
Die FwpmProviderContextGetByKey0-Funktion ruft einen Anbieterkontext ab.
Syntax
NTSTATUS FwpmProviderContextGetByKey0(
[in] HANDLE engineHandle,
const GUID *key,
FWPM_PROVIDER_CONTEXT0 **providerContext
);
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.
key
Zeigen Sie auf eine GUID, die den Anbieterkontext eindeutig identifiziert. Dies ist ein Zeiger auf dieselbe GUID, die angegeben wurde, wenn die Anwendung FwpmProviderContextAdd0- für dieses Objekt aufgerufen wurde.
providerContext
Die Anbieterkontextinformationen.
Rückgabewert
| Zurückgeben von Code/Wert | Beschreibung |
|---|---|
|
ERROR_SUCCESS 0 |
Der Anbieterkontext wurde erfolgreich abgerufen. |
|
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
Der Aufrufer muss das zurückgegebene Objekt durch einen Aufruf von FwpmFreeMemory0freigeben.
Der Aufrufer benötigt FWPM_ACTRL_READ Zugriff auf den Anbieterkontext. Weitere Informationen finden Sie unter Zugriffssteuerungs-.
FwpmProviderContextGetByKey0 ist eine spezifische Implementierung von FwpmProviderContextGetByKey. 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
Hier sind alle Links im aktuellen Dokument: