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

Item メソッドは、指定したルールがコレクション内にある場合に返します。

構文

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

[in] name

取得するルールの名前。

[out] rule

返された INetFwRule オブジェクトへの参照。

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

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

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

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

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

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