次の方法で共有

INetFwServices::Item メソッド (netfw.h)

  • [アーティクル]

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

指定したサービスがコレクション内にある場合は、そのサービスを返します。

構文

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++

リターン コード 説明
E_ACCESSDENIED
 アクセス許可の問題により、操作が中止されました。
E_OUTOFMEMORY
 メソッドは、必要なメモリを割り当てることができませんでした。
E_POINTER
 無効なポインターが原因でメソッドが失敗しました。
E_INVALIDARG
 無効なパラメーターが原因でメソッドが失敗しました。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 要求された項目が存在しないため、メソッドは失敗しました。
 

VB

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

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

リターン コード 説明
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;SP2 を使用した Windows XP での Hnetcfg.dll

こちらもご覧ください

INetFwService

INetFwServices

NET_FW_SERVICE_TYPE