Edit

INetFwServices::Item method (netfw.h)

  • Article

[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.]

Returns the specified service if it is in the collection.

Syntax

HRESULT Item(
  [in]  NET_FW_SERVICE_TYPE svcType,
  [out] INetFwService       **service
);

Parameters

[in] svcType

C++ Type of service to fetch.
VB Type of service to fetch. See NET_FW_SERVICE_TYPE

[out] service

C++ Reference to the returned INetFwService object.
VB Reference to the returned INetFwService object.

Return value

C++

Return code Description
E_ACCESSDENIED
 The operation was aborted due to permissions issues.
E_OUTOFMEMORY
 The method was unable to allocate required memory.
E_POINTER
 The method failed due to an invalid pointer.
E_INVALIDARG
 The method failed due to an invalid parameter.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 The method failed because the requested item does not exist.
 

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_OUTOFMEMORY
 The method was unable to allocate required memory.
E_POINTER
 The method failed due to an invalid pointer.
E_INVALIDARG
 The method failed due to an invalid parameter.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 The method failed because the requested item does not exist.

Requirements

Requirement Value
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

INetFwService

INetFwServices

NET_FW_SERVICE_TYPE