INetFwRules::Item 方法 (netfw.h)

如果 Item 方法位于集合中,则返回指定的规则。

语法

HRESULT Item(
  [in]  BSTR       name,
  [out] INetFwRule **rule
);

参数

[in] name

要检索的规则的名称。

[out] rule

对返回的 INetFwRule 对象的引用。

返回值

C++

如果方法成功,则返回值为S_OK。

如果方法失败,则返回值为以下错误代码之一。

返回代码 说明
E_ACCESSDENIED
由于权限问题,操作已中止。
E_INVALIDARG
方法由于参数无效而失败。
E_OUTOFMEMORY
方法无法分配所需的内存。
E_POINTER
方法由于指针无效而失败。
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)
请求的项不存在。
 

VB

如果方法成功,则返回值为S_OK。

如果方法失败,则返回值为以下错误代码之一。

返回代码 说明
E_ACCESSDENIED
由于权限问题,操作已中止。
E_INVALIDARG
方法由于参数无效而失败。
E_OUTOFMEMORY
方法无法分配所需的内存。
E_POINTER
方法由于指针无效而失败。
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)
请求的项不存在。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 netfw.h
DLL FirewallAPI.dll

另请参阅

INetFwRule

INetFwRules