共用方式為


INetFwServices::Item 方法 (netfw.h)

[Windows 防火牆 API 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 針對 Windows Vista 和更新版本,建議使用 具有進階安全性 API 的 Windows 防火牆 。]

如果位於集合中,則傳回指定的服務。

語法

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

參數

[in] svcType

C++ 要擷取的服務類型。
VB 要擷取的服務類型。 請參閱 NET_FW_SERVICE_TYPE

[out] service

C++ 傳回 之 INetFwService 對象的參考。
VB 傳回 之 INetFwService 對象的參考。

傳回值

C++

傳回碼 Description
E_ACCESSDENIED
作業因許可權問題而中止。
E_OUTOFMEMORY
方法無法配置所需的記憶體。
E_POINTER
方法因為指標無效而失敗。
E_INVALIDARG
方法因為參數無效而失敗。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
方法失敗,因為要求的專案不存在。
 

VB

如果方法成功,傳回值會S_OK。

如果方法失敗,傳回值就是下列其中一個錯誤碼。

傳回碼 Description
E_ACCESSDENIED
作業因許可權問題而中止。
E_OUTOFMEMORY
方法無法配置所需的記憶體。
E_POINTER
方法因為指標無效而失敗。
E_INVALIDARG
方法因為參數無效而失敗。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
方法失敗,因為要求的專案不存在。

規格需求

需求
最低支援的用戶端 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 netfw.h
Dll FirewallAPI.dll;windows XP sp2 上的 Hnetcfg.dll

另請參閱

INetFwService

INetFwServices

NET_FW_SERVICE_TYPE