INetFwAuthorizedApplications::Remove method

[The Windows Firewall API is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. For Windows Vista and later, use of the Windows Firewall with Advanced Security API is recommended.]

The Remove method removes an application from the collection.

Syntax

HRESULT Remove(
  BSTR imageFileName
);

Parameters

imageFileName

Application name to be removed.

Return Value

C++

If the method succeeds the return value is S_OK.

If the method fails, the return value is one of the following error codes.

Return code Description
E_ACCESSDENIED
The operation was aborted due to permissions issues.
E_INVALIDARG
The method failed due to an invalid parameter.
E_OUTOFMEMORY
The method was unable to allocate required memory.
 

VB

If the method succeeds the return value is S_OK.

If the method fails, the return value is one of the following error codes.

Return code Description
E_ACCESSDENIED
The operation was aborted due to permissions issues.
E_INVALIDARG
The method failed due to an invalid parameter.
E_OUTOFMEMORY
The method was unable to allocate required memory.

Remarks

The imageFileName parameter must be a fully qualified path and may contain environment variables.

If the application does not exist in the collection, the Remove method has no effect.

Requirements

   
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 with SP1 [desktop apps only]
Target Platform Windows
Header netfw.h
DLL FirewallAPI.dll; Hnetcfg.dll on Windows XP with SP2

See Also

INetFwAuthorizedApplications