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.
Die Funktion FwpmProviderContextGetByKey0 ruft einen Anbieterkontext ab.
HinweisFwpmProviderContextGetByKey0 ist die spezifische Implementierung von FwpmProviderContextGetByKey, die in Windows Vista verwendet wird. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen . Für Windows 7 ist FwpmProviderContextGetByKey1 verfügbar. Für Windows 8 ist FwpmProviderContextGetByKey2 verfügbar.
Syntax
DWORD FwpmProviderContextGetByKey0(
[in] HANDLE engineHandle,
[in] const GUID *key,
[out] FWPM_PROVIDER_CONTEXT0 **providerContext
);
Parameter
[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] key
Typ: const GUID*
Zeiger auf eine GUID, die den Anbieterkontext eindeutig identifiziert. Dies ist ein Zeiger auf dieselbe GUID, die angegeben wurde, als die Anwendung FwpmProviderContextAdd0 für dieses Objekt aufgerufen hat.
[out] providerContext
Typ: FWPM_PROVIDER_CONTEXT0**
Die Anbieterkontextinformationen.
Rückgabewert
Art: DWORD
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Anbieterkontext wurde erfolgreich abgerufen. |
|
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. |
Hinweise
Der Aufrufer muss das zurückgegebene Objekt durch einen Aufruf von FwpmFreeMemory0 freigeben.
Der Aufrufer benötigt FWPM_ACTRL_READ Zugriff auf den Anbieterkontext. Weitere Informationen finden Sie unter Access Control.
Anforderungen
| 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 |