Freigeben über


FwpmProviderContextGetById3-Funktion (fwpmu.h)

Ruft einen Anbieterkontext ab.

Syntax

DWORD FwpmProviderContextGetById3(
  HANDLE                 engineHandle,
  UINT64                 id,
  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.

id

Typ: _In_ UINT64

providerContext

Typ: _Outptr_ FWPM_PROVIDER_CONTEXT3**

Das hinzuzufügende Anbieterkontextobjekt.

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