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 のアセンブリとして、この API のラッパーを作ることで、各種.NET言語やスクリプト言語からこの API を容易に利用可能にしました。

Quick Start
  • C#
// You can download and add reference your VS project from "NuGet"!
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")
  • F# Script
#I "c:\some\folder"
#r "AntiVirusScanner.dll"
let scanner = new AntiVirus.Scanner()
    |> 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