Project Description
概要
This library allows you to virus-scanning a file by any .NET language(C#,F#,VB...), PowerShell,F#Script, WSH(JScript, VBScript), and any COM IDispatch client.
このライブラリは任意の.NET言語C#,F#,VB,PowerShell,F#Script,及びWSH(JScript,VBScript)等の任意のCOM IDispatchクライアントから、ファイルのウィルススキャンを可能にします。

Who virus-scan a file?
誰がウィルススキャンを行うのか?
This library is a wrapper of anti virus software product (such as "Microsoft Security Essentials") which you installed on your Windows OS.
So, this library does not work if you do not install any anti virus software produsts on your Windows OS.

このライブラリは、あなたの Windows OS にあなたがインストールしたウィルス対策ソフトウェア("Microsoft Security Essentials" のような)のラッパーに過ぎません。
実際にウィルススキャンを行うのは、そのウィルス対策ソフトウェア製品です。
そのため、何らかのウィルス対策ソフトウェア製品があなたの Windows OS にインストールされていない場合は、このライブラリは機能しません。

Why need this library?
なぜこのライブラリが必要なのか?

Windows OS provide the common API to calling the anti virus software which is installed (Of course, the anti virus software required support the API).
But, the API to calling the anti virus software provide only COM Interface style, not supported IDispatch.
So, calling this API is too difficult from any .NET language and script language.

Windows OS は、インストールされているウィルス対策ソフトウェアを呼び出すための共通の API を提供しています(もちろん、インストールされているウィルス対策ソフトウェアがこの API に対応している必要があります)。
しかしこの API は COM インターフェースとしてのみ公開されており、COM の IDispatch インターフェースにすら対応していません。
そのため、各種.NET言語やスクリプト言語から呼び出すのが極めて困難です。
そこで、.NET のアセンブリとして、この API のラッパーを作ることで、各種.NET言語やスクリプト言語からこの API を容易に利用可能にしました。

Quick Start
クイックスタート
  • C#
// You can download and add reference your VS project from "NuGet"!
// http://nuget.org/List/Packages/AntiVirusScanner
var scanner = new AntiVirus.Scanner();
var result = scanner.ScanAndClean(@"c:\some\file\path.txt");
Console.WriteLine(result); // console output is "VirusNotFound".
  • Windows PowerShell
> [Reflection.Assembly]::LoadFrom("c:\some\folder\AntiVirusScanner.dll")
> $scanner = New-Object AntiVirus.Scanner
> $scanner.ScanAndClean("c:\some\file\path.txt")
VirusNotFound
  • F# Script
#I "c:\some\folder"
#r "AntiVirusScanner.dll"
let scanner = new AntiVirus.Scanner()
scanner.ScanAndClean(@"c:\some\file\path.txt")
    |> printfn "%O" // console output is "VirusNotFound".
  • VBScript
Set scanner = CreateObject("AntiVirus.Scanner")
Set result = scanner.ScanAndClean("c:\some\file\path.txt")
WScript.Echo result 
' console output is  0, means "VirusNotFound". 1 is "VirusFound" (may be cleaned), 2 is "FileNotExist".

System Requirements
システム要件
  • .NET Framework 3.5 Client Profile
  • Any anti virus application which supported IAttachmentExecute API. / IAttachmentExecute API に対応したウィルス対策ソフトウェア
(I know this library works with "Microsoft Security Essentials" on Win7Pro(x64), "ESET NOD32 AntiVirus 4.0" on Win7Pro(x86).)

Last edited Sep 16, 2011 at 3:59 AM by jsakamoto, version 10