PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 Rückruffunktion (netfw.h)
Funktionszeigertyp des Einstiegspunkts im Dienst, den Sie aufrufen, um dynamische Schlüsselwort (keyword) Adressen nach Typ aufzulisten. Sie können eine bestimmte Teilmenge von Objekten basierend auf den übergebenen Enumerationsflags anfordern.
Hinweis
Ein Zeigertyp für diese kostenlose Funktion wird über NetFw.hveröffentlicht, aber eine Bibliothek mit statischem Link wird nicht veröffentlicht. Verwenden Sie das LoadLibraryExW/GetProcAddress-Muster zum Aufrufen dieser Funktion.
Wenn Sie GetProcAddress aufrufen, übergeben Sie ein Handle an das firewallapi.dll-Modul , und übergeben Sie FWEnumDynamicKeywordAddressesByType0 als lpProcName-Argument .
Weitere Informationen und Codebeispiele finden Sie unter Dynamische Firewallschlüsselwörter.
Syntax
PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 PfnFwenumdynamickeywordaddressesbytype0;
DWORD PfnFwenumdynamickeywordaddressesbytype0(
DWORD flags,
PFW_DYNAMIC_KEYWORD_ADDRESS_DATA0 *dynamicKeywordAddressData
)
{...}
Parameter
flags
Typ: DWORD
Wenn Sie den Wert FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_AUTO_RESOLVE verwenden, werden alle Objekte aufgelistet, für die das FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE-Flag festgelegt ist.
Wenn Sie den Wert FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE verwenden, werden alle Objekte aufgelistet, für die das flag FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEnicht festgelegt ist.
Wenn Sie den Wert FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE verwenden, werden alle Objekte aufgelistet.
dynamicKeywordAddressData
Typ: _Out_ PFW_DYNAMIC_KEYWORD_ADDRESS0*
Die Adresse eines Zeigers auf ein dynamisches Schlüsselwort (keyword) Adressobjekt, das eine verknüpfte Liste der zurückgegebenen Objekte enthält. Sie müssen diese Adresse freigeben, indem Sie FWFreeDynamicKeywordAddressData0 aufrufen.
Rückgabewert
Typ: DWORD
Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück. Andernfalls wird einer der folgenden Werte zurückgegeben.
| Rückgabewert | BESCHREIBUNG |
|---|---|
| ERROR_INVALID_PARAMETER | Für den Flags-Parameter wurde ein Nullwert übergeben. |
Hinweise
Sie müssen die Adresse des ersten zurückgegebenen Objekts in der Liste (dem Kopf der Liste) freigeben, indem Sie FWFreeDynamicKeywordAddressData0 aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 Build 20348 |
| Unterstützte Mindestversion (Server) | Windows 10 Build 20348 |
| Zielplattform | Windows |
| Kopfzeile | netfw.h |
| DLL | firewallapi.dll |