共用方式為


INetFwPolicy::GetProfileByType 方法 (netfw.h)

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

擷取所要求類型的配置檔。

語法

HRESULT GetProfileByType(
  [in]       NET_FW_PROFILE_TYPE profileType,
  [out, ref] INetFwProfile       **profile
);

參數

[in] profileType

來自 NET_FW_PROFILE_TYPE的配置檔類型。

[out, ref] profile

INetFwProfile 類型的擷取配置檔

INetFwProfile 類型的擷取配置檔

傳回值

C++

傳回碼 Description
E_ACCESSDENIED
作業因許可權問題而中止。
E_INVALIDARG
方法因為參數無效而失敗。
E_OUTOFMEMORY
方法無法配置所需的記憶體。
E_POINTER
方法因為指標無效而失敗。
 

VB

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

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

傳回碼 Description
E_ACCESSDENIED
作業因許可權問題而中止。
E_INVALIDARG
方法因為參數無效而失敗。
E_OUTOFMEMORY
方法無法配置所需的記憶體。
E_POINTER
方法因為指標無效而失敗。

規格需求

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

另請參閱

INetFwPolicy

INetFwProfile

NET_FW_PROFILE_TYPE