API du moteur d'analyse des virus

Dernière modification : mercredi 15 août 2012

S’applique à : SharePoint Foundation 2010

Dans cet article
IMso_VirusScanner, interface
Initialize, méthode
Scan, méthode
Clean, méthode
ILockBytes, interface

Cette rubrique décrit l'API requise pour la construction d'un moteur d'analyse des virus (VSE) pour l'analyse et le nettoyage des documents dans Windows SharePoint Services 3.0. Pour obtenir une présentation générale du VSE et de sa configuration minimale requise, voir Présentation : implémentation de l'API du moteur d'analyse antivirus.

IMso_VirusScanner, interface

Le tableau suivant décrit les méthodes fournies par l'interface IMso_VirusScanner.

Notes

L'application hôte instancie un objet IMso_VirusScanner et effectue les tâches suivantes :

• Instancie l'antivirus en tant que INPROC_SERVER dans un cloisonnement sans thread.

• Appelle la méthode Initialize avant d'appeler toute autre méthode.

• Vérifie qu'il n'y a aucune requête Scan en suspens avant d'appeler Release.

• Effectue des appels simultanés à Scan ou Clean à partir de plusieurs threads une fois la méthode Initialize terminée et avant d'appeler Release.

Le scanneur compatible est une instance de l'interface IMso_VirusScanner et effectue les tâches suivantes :

• Toutes les initialisations et allocations de ressources par le biais de la méthode Initialize.

• Aucun appel vers des API de système d'exploitation avec des heures d'achèvement incertaines au moment de l'analyse ou du nettoyage. Parmi les différents exemples, citons les E/S de fichier et la manipulation du Registre.

Initialize, méthode

Effectue l'initialisation par instance de l'analyseur et renvoie des informations sur l'instance IMso_VirusScanner active.

Syntaxe

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

Paramètres

Valeur de retour

Réussite : renvoie S_OK si l'initialisation a réussi.

Échec : renvoie un code d'erreur.

Notes

Cette méthode doit être appelée une seule fois par instance IMso_VirusScanner, immédiatement après la création de l'instance et avant d'appeler la méthode Scan ou Clean.

Scan, méthode

Analyse le contenu et renvoie l'état d'infection et les informations sur le virus, le cas échéant.

Syntaxe

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

Paramètres

L'hôte libère la valeur renvoyée à l'aide de la fonction SysFreeString.

Valeur de retour

Réussite : renvoie S_OK si l'opération a réussi et les paramètes pdwStatus et pbstrVirusInfo contiennent des informations valides.

Échec : renvoie un code d'erreur.

Notes

L'hôte appelle cette méthode à partir de plusieurs threads simultanément. Le scanneur est supposé effectuer les demandes simultanément sans sérialisation interne des demandes.

Clean, méthode

Tente de supprimer l'infection du contenu.

Syntaxe

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

Paramètres

L'hôte libère la valeur renvoyée à l'aide de la fonction SysFreeString.

Valeur de retour

Réussite : renvoie S_OK si l'opération a réussi et les paramètres pdwStatus, wzVirusInfo et pilbOutput contiennent des informations valides.

Notes

L'hôte appelle cette méthode à partir de plusieurs threads simultanément. Le scanneur est supposé effectuer les demandes simultanément sans sérialisation interne des demandes.

ILockBytes, interface

L'interface ILockBytes est exposée pour permettre au fournisseur d'extraire des informations supplémentaires sur le fichier, lesquelles peuvent inclure le nom du fichier, son type, sa taille, etc. Pour obtenir une description complète de cette interface sur MSDN, voir ILockBytes.

Syntaxe

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;

Membres