INetFwRules::Add メソッド (netfw.h)
Add メソッドは、コレクションに新しい規則を追加します。
構文
HRESULT Add(
[in] INetFwRule *rule
);
パラメーター
[in] rule
INetFwRule オブジェクトを使用してコレクションに追加する規則。
戻り値
C++
メソッドが成功した場合、戻り値はS_OK。メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
アクセス許可の問題が原因で操作が中止されました。 |
|
パラメーターが無効であるため、メソッドは失敗しました。 |
|
オブジェクトがコレクションに既に存在するため、メソッドは失敗しました。 |
VB
メソッドが成功した場合、戻り値はS_OK。メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
アクセス許可の問題が原因で操作が中止されました。 |
|
パラメーターが無効であるため、メソッドは失敗しました。 |
|
オブジェクトがコレクションに既に存在するため、メソッドは失敗しました。 |
注釈
送信されているルール識別子と同じルール識別子を持つルールが既に存在する場合は、既存のルールが上書きされます。
LocalAppPackageId を指定してファイアウォール規則を追加すると、予期しない動作が発生する可能性があり、サポートされていません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | netfw.h |
| [DLL] | FirewallAPI.dll |