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++
リターン コード | 説明 |
---|---|
|
アクセス許可の問題により、操作が中止されました。 |
|
メソッドは、必要なメモリを割り当てることができませんでした。 |
|
無効なポインターが原因でメソッドが失敗しました。 |
|
無効なパラメーターが原因でメソッドが失敗しました。 |
|
要求された項目が存在しないため、メソッドは失敗しました。 |
VB
メソッドが成功した場合、戻り値はS_OK。メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
リターン コード | 説明 |
---|---|
|
アクセス許可の問題により、操作が中止されました。 |
|
メソッドは、必要なメモリを割り当てることができませんでした。 |
|
無効なポインターが原因でメソッドが失敗しました。 |
|
無効なパラメーターが原因でメソッドが失敗しました。 |
|
要求された項目が存在しないため、メソッドは失敗しました。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 SP1 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | netfw.h |
[DLL] | FirewallAPI.dll;SP2 を使用した Windows XP での Hnetcfg.dll |