次の方法で共有

INetFwMgr::IsIcmpTypeAllowed メソッド (netfw.h)

  • [アーティクル]

[Windows Firewall API は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 Windows Vista 以降の場合は、セキュリティが 強化された Windows ファイアウォール API を使用することをお勧めします。]

指定した ICMP の種類が許可されているかどうかを判断します。

構文

HRESULT IsIcmpTypeAllowed(
  [in]  NET_FW_IP_VERSION ipVersion,
  [in]  BSTR              localAddress,
  [in]  BYTE              type,
  [out] VARIANT           *allowed,
  [out] VARIANT           *restricted
);

パラメーター

[in] ipVersion

トラフィックの IP バージョン。 これは NET_FW_IP_VERSION_ANYできません。

トラフィックの IP バージョン。 これは NET_FW_IP_VERSION_ANYできません。

[in] localAddress

ドット付き 10 進数の IPv4 アドレスまたはトラフィックのローカル アドレスを指定する IPv6 16 進アドレス。 通常、これはバインドに渡されるアドレスです。 localAddress が NULL の場合、関数はポートがすべてのインターフェイスに対して許可されているかどうかを判断します。

[in] type

ICMP の種類。 使用可能な ICMP の種類の一覧については、「 ICMP 型番号」を参照してください。

[out] allowed

少なくとも一部のローカル インターフェイスとリモート アドレスに対してポートが許可されるかどうかをVARIANT_TRUEまたはVARIANT_FALSEの値で示します。

[out] restricted

VARIANT_TRUEの値によって示されるか、一部のローカル インターフェイスまたはリモート アドレスがこのポートに対してブロックされているかどうかをVARIANT_FALSEします。 たとえば、ポートがローカル サブネットのみに制限されている場合です。

戻り値

C++

リターン コード 説明
E_ACCESSDENIED
 アクセス許可の問題により、操作が停止されました。
E_INVALIDARG
 パラメーターが無効であるため、メソッドは失敗しました。
E_OUTOFMEMORY
 メソッドは、必要なメモリを割り当てることができませんでした。
E_POINTER
 ポインターが有効でなかったため、メソッドが失敗しました。
 

VB

メソッドが成功した場合、戻り値は S_OK。

メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。

リターン コード 説明
E_ACCESSDENIED
 アクセス許可の問題により、操作が停止されました。
E_INVALIDARG
 パラメーターが無効であるため、メソッドは失敗しました。
E_OUTOFMEMORY
 メソッドは、必要なメモリを割り当てることができませんでした。
E_POINTER
 ポインターが有効でなかったため、メソッドが失敗しました。

注釈

INetFwPolicy2::IsRuleGroupEnabled メソッドは、通常、このメソッドの代わりに推奨されます。

要件

要件 値
サポートされている最小のクライアント Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー netfw.h
[DLL] FirewallAPI.dll;SP2 を使用した Windows XP での Hnetcfg.dll

こちらもご覧ください

INetFwMgr

NET_FW_IP_VERSION