Edit

Share via

PFN_FWDELETEDYNAMICKEYWORDADDRESS0 callback function (netfw.h)

  • Article

Function pointer type of the entry point in the service that you call to delete the dynamic keyword address with the specified 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 FWDeleteDynamicKeywordAddress0 as the lpProcName argument.

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

Syntax

PFN_FWDELETEDYNAMICKEYWORDADDRESS0 PfnFwdeletedynamickeywordaddress0;

DWORD PfnFwdeletedynamickeywordaddress0(
  GUID dynamicKeywordAddressId
)
{...}

Parameters

dynamicKeywordAddressId

Type: GUID

The id of the dynamic keyword address object to delete.

Return value

Type: DWORD

If the function succeeds (the object was successfully deleted, or no object with the specified ID exists), then it returns ERROR_SUCCESS. Otherwise, it returns one of the following values.

Return value Description
ERROR_ACCESS_DENIED The caller doesn't have proper permissions to operate on the object with the specified ID. This likely means that the object is managed by MDM (it has origin type FW_DYNAMIC_KEYWORD_ORIGIN_MDM.

Remarks

Note

This function returns ERROR_SUCCESS even if the object with the specified ID doesn't exist.

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