Edit

Share via

PFN_FWENUMDYNAMICKEYWORDADDRESSBYID0 callback function (netfw.h)

  • Article

Function pointer type of the entry point in the service that you call to enumerate the specific dynamic keyword addresses by ID.

Note

A pointer type for this free function is published via NetFw.h, but a static-link library isn't published. Use the LoadLibraryExW/GetProcAddress pattern for calling this function.

When you call GetProcAddress, pass a handle to the firewallapi.dll module, and pass FWEnumDynamicKeywordAddressById0 as the lpProcName argument.

For more info, and code examples, see Firewall dynamic keywords.

Syntax

PFN_FWENUMDYNAMICKEYWORDADDRESSBYID0 PfnFwenumdynamickeywordaddressbyid0;

DWORD PfnFwenumdynamickeywordaddressbyid0(
  GUID dynamicKeywordAddressId,
  PFW_DYNAMIC_KEYWORD_ADDRESS_DATA0 *dynamicKeywordAddressData
)
{...}

Parameters

dynamicKeywordAddressId

Type: GUID

The id of the dynamic keyword address object to enumerate.

dynamicKeywordAddressData

Type: _Out_ PFW_DYNAMIC_KEYWORD_ADDRESS0*

The address of a pointer to a dynamic keyword address object, which will hold the object returned. You must free this object by calling FWFreeDynamicKeywordAddressData0.

Return value

Type: DWORD

If the function succeeds, then it returns ERROR_SUCCESS.

Remarks

If the object returned via dynamicKeywordAddressData is non-NULL, then its pNext field is always null.

You must free the returned addresses object by calling FWFreeDynamicKeywordAddressData0.

Requirements

Requirement Value
Minimum supported client Windows 10 Build 20348
Minimum supported server Windows 10 Build 20348
Target Platform Windows
Header netfw.h
DLL firewallapi.dll

See also