ウイルス スキャン エンジン API

最終更新日: 2015年3月9日

適用対象: SharePoint Foundation 2010

この記事の内容
IMso_VirusScanner インターフェイス
Initialize メソッド
Scan メソッド
Clean メソッド
ILockBytes インターフェイス

ここでは、Windows SharePoint Services 3.0 内のドキュメントのスキャンおよびクリーンに対応するウイルス スキャン エンジン (VSE) を構築するために必要な API について説明します。VSE およびその要件の概要については、「概要 : ウイルス スキャン エンジン API の実装」を参照してください。

IMso_VirusScanner インターフェイス

以下の表は、IMso_VirusScanner インターフェイスが提供するメソッドについて説明しています。

備考 :

ホスト アプリケーションが IMso_VirusScanner オブジェクトをインスタンス化し、以下のタスクを実行します。

• ウィルス検出プログラムをフリー スレッド化したアパートメントの INPROC_SERVER としてインスタンス化します。

• 最初に Initialize メソッドを呼び出してから、他のメソッドを呼び出します。

• Release を呼び出す前に、未解決の Scan 要求がないことを確認します。

• Initialize メソッドが完了した後、Release を呼び出す前に、複数のスレッドから Scan または Clean を同時に呼び出します。

対応する検出プログラムは、IMso_VirusScanner インターフェイスのインスタンスで、以下のタスクを実行します。

• Initialize メソッドを使用したすべての初期化とリソースの割り当て。

• NO はスキャンまたはクリーニング中に、不確かな完了時間での任意のオペレーティング システム API を呼び出します。例には、ファイルの I/O 、レジストリ操作、およびその他が含まれます。

Initialize メソッド

スキャナのインスタンス単位の初期化をすべて実行し、現在の IMso_VirusScanner インスタンスに関する情報を返します。

構文

STDMETHOD Initialize (
      BSTR *pbstrProduct,
      DWORD *pdwProductVersion
);

パラメータ

戻り値

成功 : 初期化に成功した場合、S_OK を返します。

失敗 : エラー コードを返します。

備考 :

このメソッドは、インスタンスが作成された直後、Scan メソッドまたは Clean メソッドを呼び出す前に、IMso_VirusScanner インスタンスごとに 1 回呼び出す必要があります。

Scan メソッド

コンテンツをスキャンし、感染の状態とウィルス情報 (取得できた場合) を返します。

構文

STDMETHOD Scan (
      ILockBytes *pilb,
      DWORD *pdwStatus,
      BSTR *pbstrVirusInfo
);

パラメータ

ホストは SysFreeString 関数を使用して、戻り値を解放します。

戻り値

成功 : 操作が正常に完了した場合、S_OK が返され、pdwStatus および pbstrVirusInfo パラメータに有効な情報が含まれます。

失敗 : エラー コードを返します。

備考 :

ホストは、同時に複数のスレッドからこのメソッドを呼び出します。検出プログラムは、要求を内部でシリアル化することなく、同時に実行することを要求されます。

Clean メソッド

コンテンツからウィルス感染を取り除きます。

構文

STDMETHOD Clean (
      ILockBytes *pilbInput,
      ILockBytes *pilbOutput,
      DWORD *pdwStatus,
      BSTR *pbstrVirusInfo
);

パラメータ

ホストは SysFreeString 関数を使用して、戻り値を解放します。

戻り値

成功 : 操作が正常に完了した場合、S_OK が返され、pdwStatus、wzVirusInfo、および pilbOutput パラメータに有効な情報が含まれます。

備考 :

ホストは、同時に複数のスレッドからこのメソッドを呼び出します。検出プログラムは、要求を内部でシリアル化することなく、同時に実行することを要求されます。

ILockBytes インターフェイス

ILockBytesILockBytesILockBytes ILockBytes

構文

typedef struct tagSTATSTG {
      LPWSTR pwcsName;
      DWORD type;
      ULARGE_INTEGER cbSize;
      FILETIME mtime;
      FILETIME ctime;
      FILETIME atime;
      DWORD grfMode;
      DWORD grfLocksSupported;
      CLSID clsid;
      DWORD grfStateBits;
      DWORD reserved;
} STATSTG;

メンバ