OSDN Git Service

アイコン取得に失敗しアンインストール・パッケージ情報表示ができない不具合を修正した。(アイコンは表示されないが、作業ができるようにした)
[applistation/AppliStation.git] / na-get-lib / NaGet.Net / DownloadScanner.cs
index af3e39e..5dc9b7c 100644 (file)
@@ -1,4 +1,10 @@
-using System;\r
+/*\r
+ * This code is based on /mozilla/source/toolkit/components/downloads/src/nsDownloadScanner.cpp\r
+ * and sample code at https://bugzilla.mozilla.org/show_bug.cgi?id=103487,\r
+ * created by Rob Arnold.\r
+ */\r
+\r
+using System;\r
 using System.Reflection;\r
 using System.Collections.Generic;\r
 using System.Runtime.InteropServices;\r
@@ -7,6 +13,9 @@ using NaGet.InteropServices;
 \r
 namespace NaGet.Net\r
 {\r
+       /// <summary>\r
+       /// ダウンロードしたファイルをスキャンする\r
+       /// </summary>\r
        public class DownloadScanner : IDisposable\r
        {\r
                #region COMInterop\r
@@ -54,28 +63,35 @@ namespace NaGet.Net
                }\r
                \r
                private List<IOfficeAntiVirus> scanners;\r
-               \r
+\r
+               /// <summary>\r
+               /// コンストラクタ。内部でCOM呼び出し初期化(CoInitialize)されます。\r
+               /// </summary>\r
                public DownloadScanner()\r
                {\r
                        ComDirectAccess.CoInitialize(IntPtr.Zero);\r
                }\r
                \r
+               /// <summary>\r
+               /// 内部でCOM開放(CoUninitialize)します。必ず呼び出す必要があります。\r
+               /// </summary>\r
                public void Dispose()\r
                {\r
-                       if ((scanners != null) && (scanners.Count > 0)) {\r
-                               foreach (IOfficeAntiVirus i in scanners) {\r
-                                       Marshal.ReleaseComObject(i);\r
-                               }\r
-                               scanners.Clear();\r
-                       }\r
-                       \r
+                       Release();\r
                        ComDirectAccess.CoUninitialize();\r
                }\r
                \r
+               /// <summary>\r
+               /// ウイルススキャンがあるかないか\r
+               /// </summary>\r
+               /// <remarks>Init()呼出し後に使える</remarks>\r
                public bool HasScanner {\r
                        get { return scanners.Count > 0; }\r
                }\r
                \r
+               /// <summary>\r
+               /// 初期化処理としてウイルススキャンを探す。\r
+               /// </summary>\r
                public void Init()\r
                {\r
                        scanners = new List<IOfficeAntiVirus>();\r
@@ -91,6 +107,32 @@ namespace NaGet.Net
                        }\r
                }\r
                \r
+               /// <summary>\r
+               /// ウイルススキャンのオブジェクトを開放しInitの前の状態に戻す。\r
+               /// </summary>\r
+               public void Release()\r
+               {\r
+                       if ((scanners != null) && (scanners.Count > 0)) {\r
+                               foreach (IOfficeAntiVirus i in scanners) {\r
+                                       Marshal.ReleaseComObject(i);\r
+                               }\r
+                               scanners.Clear();\r
+                       }\r
+               }\r
+               \r
+               /// <summary>\r
+               /// ファイルをスキャンする。ウイルススキャンが複数個見つかっている\r
+               /// ならばそれらすべてでスキャンする。\r
+               /// ウイルススキャンの実装によるが、ウイルス発見時にはダイアログが開く。\r
+               /// ウイルスの処理はユーザに委ねられるので、それの制御は一切できない。\r
+               /// </summary>\r
+               /// <remarks>ウイルスが見つかったか否かは取得できない。</remarks>\r
+               /// <remarks>本メソッド呼び出し後にウイルスが退避されているかもしれないが、ファイルの存在確認でしかそれをチェックできない</remarks>\r
+               /// <param name="path">ファイルのパス</param>\r
+               /// <param name="origin">ファイルをダウンロードしたURL。nullであってはならない</param>\r
+               /// <exception cref="COMException">COMのエラー発生時。たとえば、AVGではウイルスと検出されたのにユーザが「無視」を指定したときにも投げられる。</exception>\r
+               /// <returns>ウイルススキャンがされたか否か</returns>\r
+               /// <remarks>Init()呼出し後に使える</remarks>\r
                public bool Scan(string path, string origin)\r
                {\r
                        if (scanners.Count <= 0) {\r
@@ -106,6 +148,7 @@ namespace NaGet.Net
                        info.pwzOrigURL = origin;\r
                        \r
                        foreach (IOfficeAntiVirus i in scanners) {\r
+                               if (! System.IO.File.Exists(path)) break;\r
                                i.Scan(ref info);\r
                        }\r
                        return true;\r