INetFwRules::Item method

The Item method returns the specified rule if it is in the collection.

Syntax

HRESULT Item(
  BSTR       name,
  INetFwRule **rule
);

Parameters

name

Name of the rule to retrieve.

rule

Reference to the returned INetFwRule object.

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

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header netfw.h
DLL FirewallAPI.dll

See Also

INetFwRule

INetFwRules