INetFwAuthorizedApplications::Add メソッド (netfw.h)
[Windows Firewall API は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 Windows Vista 以降の場合は、セキュリティが 強化された Windows ファイアウォール API を使用することをお勧めします。]
Add メソッドは、新しいアプリケーションをコレクションに追加します。
構文
HRESULT Add(
[in] INetFwAuthorizedApplication *app
);
パラメーター
[in] app
| C++ | INetFWAuthorizedApplication オブジェクトを使用してコレクションに追加するアプリケーション。 |
| VB | INetFWAuthorizedApplication オブジェクトを使用してコレクションに追加するアプリケーション。 |
戻り値
C++
メソッドが成功した場合、戻り値はS_OK。メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
アクセス許可の問題により、操作が中止されました。 |
|
パラメーターが無効であるため、メソッドは失敗しました。 |
|
メソッドは、必要なメモリを割り当てることができませんでした。 |
|
オブジェクトが既にコレクション内にあるため、メソッドは失敗しました。 |
VB
メソッドが成功した場合、戻り値はS_OK。メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
アクセス許可の問題により、操作が中止されました。 |
|
パラメーターが無効であるため、メソッドは失敗しました。 |
|
メソッドは、必要なメモリを割り当てることができませんでした。 |
|
オブジェクトが既にコレクション内にあるため、メソッドは失敗しました。 |
注釈
同じパスを持つアプリケーションが既に存在する場合は、既存の設定が上書きされます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 SP1 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | netfw.h |
| [DLL] | FirewallAPI.dll;SP2 を使用した Windows XP での Hnetcfg.dll |