Numéro d'article: 927745 - Dernière mise à jour: mardi 13 février 2007 - Version: 2.4

Informations détaillées à l'intention des développeurs qui utilisent le fichier d'analyse hors connexion Windows Update

Sommaire

Agrandir tout | Réduire tout

Résumé

Une nouvelle version du fichier d'analyse hors connexion Microsoft Windows Update (WU) a été publiée en novembre 2006, conjointement à la version existante du fichier, Wsusscan.cab. Le nouveau fichier d'analyse hors connexion WU, Wsusscn2.cab, a un nouveau format. Toute solution d'analyse qui utilise le fichier d'analyse hors connexion WU existant doit être mise à jour pour utiliser la nouvelle version du fichier avant mars 2007.

Toute solution non-Microsoft qui utilise le fichier d'analyse hors connexion WU doit disposer de la version mise à jour de Windows Update Agent pour tous les systèmes d'exploitation Microsoft Windows 2000, Microsoft Windows XP et Microsoft Windows Server 2003. Les ordinateurs Windows Vista disposeront de la version mise à jour de Windows Update Agent lors de la publication du système d'exploitation. Windows Vista n'aura donc pas besoin de mise à jour.

Certaines solutions non-Microsoft utilisant le fichier d'analyse hors connexion WU pour la détection de mises à jour de sécurité hors connexion peuvent également nécessiter la version mise à jour. Ces solutions requièrent cette version mise à jour du fichier d'analyse hors connexion WU si elles lisent ce fichier au lieu d'utiliser l'interface API de Windows Update. Nous ne recommandons pas que ces solutions lisent ce fichier directement car il peut faire l'objet de modifications. Nous conseillons plutôt aux développeurs d'utiliser la fonctionnalité d'analyse hors connexion de Windows Update Agent. Pour plus d'informations sur cette fonctionnalité, reportez-vous au site Web MSDN (Microsoft Developer Network) à l'adresse suivante (en anglais) :
http://msdn2.microsoft.com/en-us/library/aa387099.aspx (http://msdn2.microsoft.com/en-us/library/aa387099.aspx)

Plus d'informations

Microsoft a modifié le format interne du fichier d'analyse hors connexion WU pour résoudre le problème expliqué dans l'article 926464 de la Base de connaissances Microsoft. Toute solution non-Microsoft qui accède à ce fichier d'une manière qui n'est pas documentée dans l'interface API publique peut nécessiter la version mise à jour du fichier.

Tous les produits, outils et solutions qui utilisent le fichier Wsusscan.cab à partir de l'interface API de Windows Update Agent doivent être mis à jour avant mars 2007. Ils doivent pouvoir utiliser le nouveau fichier Wsusscn2.cab afin de le télécharger à partir du nouvel emplacement. Par ailleurs, tous les ordinateurs clients doivent disposer de la version mise à jour de Windows Update Agent appropriée. Toute solution Microsoft qui accède directement au fichier CAB peut nécessiter des modifications supplémentaires en raison des changements apportés au format interne.

Accès direct au fichier Wsusscn2.cab

Nous vous déconseillons d'accéder directement au fichier Wsusscn2.cab car son format peut être modifié. Toutefois, cet article inclut des informations destinées aux développeurs qui disposent de solutions accédant directement au fichier.

Procédure pour déterminer si la version de Windows Update Agent est correcte pour le fichier Wsusscn2.cab

Si la version de Windows Update Agent installée sur l'ordinateur est antérieure à la version minimale requise du format de package d'analyse correspondant, elle ne peut pas fonctionner avec le package d'analyse. De plus, ses interfaces API associées au package d'analyse peuvent retourner le code WU_E_OL_NEWCLIENT_REQUIRED et d'autres codes HRESULT. Dans le pire des cas, il est possible que la version installée de l'interface API de Windows Update Agent ne prenne en charge aucune fonctionnalité associée au package d'analyse. Par exemple, l'interface API de Windows Update Agent peut ne pas prendre en charge l'interface IUpdateServiceManager. Pour des informations sur la façon d'éviter ce problème, reportez-vous au site Web à l'adresse suivante (en anglais) :
http://msdn2.microsoft.com/en-us/library/aa387099.aspx (http://msdn2.microsoft.com/en-us/library/aa387099.aspx)
Ces informations vous permettront de comprendre comment l'application peut installer la dernière version de Windows Update Agent sur l'ordinateur.

L'application peut installer la dernière version de Windows Update Agent sur l'ordinateur avant qu'il n'utilise des packages d'analyse avec l'interface API de Windows Update Agent. Pour plus d'informations sur la façon d'utiliser des packages d'analyse pour rechercher des mises à jour dans un environnement hors connexion, reportez-vous au site Web à l'adresse suivante (en anglais) :
http://msdn2.microsoft.com/en-us/library/aa387290.aspx (http://msdn2.microsoft.com/en-us/library/aa387290.aspx)
Pour plus d'informations sur l'interface IupdateCollection, reportez-vous au site Web à l'adresse suivante (en anglais) :
http://msdn2.microsoft.com/en-us/library/aa386107.aspx (http://msdn2.microsoft.com/en-us/library/aa386107.aspx)
Pour plus d'informations sur le package d'analyse, reportez-vous au site Web à l'adresse suivante (en anglais) :
http://msdn2.microsoft.com/en-us/library/aa386821.aspx (http://msdn2.microsoft.com/en-us/library/aa386821.aspx)
Pour plus d'informations sur l'interface API de Windows Update Agent, reportez-vous au site Web à l'adresse suivante (en anglais) :
http://msdn2.microsoft.com/en-us/library/aa387099.aspx (http://msdn2.microsoft.com/en-us/library/aa387099.aspx)

Modifications apportées au format de fichier CAB

Le fichier Wsusscan.cab contient un seul fichier CAB. Il s'agit du fichier Package.cab. Le fichier Wsusscn2.cab contient les fichiers suivants :
  • Un fichier Index.xml. Ce fichier contient les composants suivants :
    • Élément <Index>
      Attribut Version (numéro)
      Requis ? Oui
      Signification : Il s'agit du numéro de version qui utilise le format du fichier Index.xml.
      Remarques : Cette valeur doit être numériquement équivalente à Version="1".
    • Élément <CabList>
      Attribut Xor (nombre)
      Requis ? Non
      Valeur par défaut : Xor="0"
      Signification :
      • Xor="1" indique que tous les fichiers CAB définis par les éléments <Cab> enfants, à l'exception du fichier Package.cab, ont été obscurcis à l'aide d'une opération Not au niveau du bit. En d'autres termes, les 1 et les 0 de chaque bit du contenu de tous les fichiers CAB définis, à l'exception du fichier Package.cab, sont inversés. Ce comportement permet d'améliorer les performances de Windows Update Agent lors du traitement du package d'analyse en ignorant le temps pris par certains logiciels antivirus sur les ordinateurs clients pour vérifier l'absence de virus dans ces fichiers CAB.
      • Xor="0" indique que tous les fichiers CAB définis par les éléments <Cab> enfants ne sont pas obscurcis à l'aide d'une opération Not au niveau du bit.
    • Élément <Cab>
      Attribut Name (chaîne)
      Requis ? Oui
      Signification : Nom du fichier CAB défini par l'élément <Cab>.
      Remarques :
      • La valeur du premier élément <Cab> défini dans <CabList> doit être Package.cab.

        Remarque Cette valeur est sensible à la casse.
      • Généralement, si la valeur est Xor="1" , les fichiers CAB définis en second, troisième, etc. par les éléments <Cab> sont nommés Package2.wu, Package3.wu, etc. Cela est vrai si les éléments sont présents.
      • Généralement, si la valeur est Xor="0" , les fichiers CAB définis en second, troisième, etc. par les éléments <Cab> sont nommés Package2.cab, Package3.cab, etc. Cela est vrai si les éléments sont présents.
      Attribut RangeStart (nombre)
      Requis ? Non pour le fichier Package.cab, oui pour le fichier Packagenuméro_version.wu
      Valeur par défaut : (Aucune)
      Signification :
      • Les fichiers spécifiques à un RevisionId sont ceux contenus dans les dossiers C, E, I et X. Ils peuvent se répartir dans plusieurs des fichiers CAB définis dans l'élément <CabList>. Toutefois, les spécifications Wsusscn2.cab exigent que tous les fichiers spécifiques à un RevisionId particulier soient stockés dans un seul de ces fichiers CAB. L'attribut RangeStart enregistre la valeur RevisionId la plus basse des fichiers spécifiques à un RevisionId contenus dans le fichier CAB correspondant à l'élément <Cab>.
      • L'absence de valeur d'attribut signifie qu'aucun fichier spécifique à un RevisionId n'est stocké dans le fichier CAB correspondant. Généralement, l'élément <Cab> du fichier Package.cab ne spécifie pas de valeur d'attribut RangeStart.
      Remarques :
      • Si la valeur d'attribut RangeStart est présente dans le premier élément <Cab> répertorié dans le fichier Index.xml, elle doit être "0".
      • Si les valeurs d'attribut RangeStart définies dans les éléments <Cab> sont présentes dans le fichier Index.xml, elles doivent être triées par ordre croissant et ne pas se chevaucher.
      • En combinant les valeurs d'attribut RangeStart définies dans les éléments <Cab> dans le fichier Index.xml, l'application peut déduire la plage continue et sans chevauchement des RevisionIds couverts par chacun de ces fichiers CAB. Le fichier CAB qui correspond au dernier élément <Cab> défini possède une valeur d'attribut RangeStart contenant tous les fichiers spécifiques à un RevisionId, à partir de la valeur RevisionId spécifiée dans la valeur d'attribut.
    • Attribut FilesDir (nombre)
      Requis : Non
      Valeur par défaut : FilesDir="0"
      Signification :
      • FilesDir="1" indique que le fichier CAB qui correspond à l'élément <Cab> contient le dossier Files.
      • FilesDir="0" indique que le fichier CAB qui correspond à l'élément <Cab> ne contient pas le dossier Files.
      Remarque Il n'existe qu'un seul élément <Cab> qui spécifie FilesDir="1".
  • Un fichier Package.cab ou un fichier Packagenuméro_version.wu. Ces fichiers contiennent les composants suivants :
    • Package.xml
      Le fichier Package.xml est dans le même format et le même schéma que le fichier Package.cab contenu dans le fichier Wsusscan.cab. Comme dans l'ancien format, le fichier reste dans le fichier Package.cab.
    • Dossier C
      Le dossier C contient le même type de contenu que le dossier Core du fichier Package.cab qui se trouve dans le fichier Wsusscan.cab. Contrairement à l'ancien format, le dossier C couvre un ou plusieurs fichiers CAB Package.cab ou Packagenuméro_version.wu. Ce comportement se produit selon les valeurs d'attribut RangeStart dans les éléments <Cab> correspondants définis dans le fichier Index.xml.
    • Dossier E
      Le dossier E contient le même type de contenu que le dossier Eula du fichier Package.cab qui se trouve dans le fichier Wsusscan.cab. Contrairement à l'ancien format, le dossier E couvre un ou plusieurs fichiers CAB Package.cab ou Packagenuméro_version.wu, selon les valeurs d'attribut RangeStart dans les éléments <Cab> correspondants. Ces éléments sont définis dans le fichier Index.xml.
    • Dossier Files
      Le dossier Files contient le même type de contenu que le dossier Files du fichier Package.cab qui se trouve dans le fichier Wsusscan.cab. Contrairement à l'ancien format, le dossier est stocké dans un seul fichier CAB Package.cab ou Packagenuméro_version.wu. Ce comportement se produit selon la valeur d'attribut FilesDir dans l'élément <Cab> correspondant. Cet élément se trouve dans le fichier Index.xml.
    • Dossier I
      Le dossier I contient le même type de contenu que le dossier Localized du fichier Package.cab qui se trouve dans le fichier Wsusscan.cab. La seule différence est que les fichiers qui correspondent aux mises à jour logicielles non fournies, qui ne peuvent pas être explicitement déployées, sont absents du fichier Wsusscn2.cab pour des raisons de performances sur l'ordinateur de l'utilisateur final. Les propriétés localisées supprimées de ces mises à jour sont générées automatiquement par Windows Update Agent au cours de l'exécution. Contrairement à l'ancien format, le dossier I couvre un ou plusieurs fichiers CAB Package.cab ou Packagenuméro_version.wu, selon les valeurs d'attribut RangeStart dans les éléments <Cab> correspondants. Ces éléments sont définis dans le fichier Index.xml.
    • Dossier X
      Le dossier X contient le même type de contenu que le dossier Extended du fichier Package.cab qui se trouve dans le fichier Wsusscan.cab. Contrairement à l'ancien format, le dossier X couvre un ou plusieurs fichiers CAB Package.cab ou Packagenuméro_version.wu. Ce comportement se produit selon les valeurs d'attribut RangeStart contenues dans les éléments<Cab> correspondants. Ces éléments sont définis dans le fichier Index.xml.
Pour plus d'informations sur l'outil Windows Update Agent, reportez-vous au site Web de Microsoft à l'adresse suivante (en anglais) :
http://msdn2.microsoft.com/en-us/library/aa387099.aspx (http://msdn2.microsoft.com/en-us/library/aa387099.aspx)

Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft Baseline Security Analyzer 2.0
  • Microsoft Systems Management Server 2003 Enterprise Edition
  • Microsoft Windows Server 2003, Standard Edition (32-bit x86)
  • Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)
  • Microsoft Windows Server 2003, Datacenter Edition (32-bit x86)
  • Microsoft Windows Server 2003, Enterprise x64 Edition
  • Microsoft Windows Server 2003, Datacenter x64 Edition
  • Microsoft Windows Server 2003, Enterprise Edition for Itanium-based Systems
  • Microsoft Windows Server 2003, Datacenter Edition for Itanium-Based Systems
  • Microsoft Windows XP Professional
  • Microsoft Windows XP Édition familiale
  • Microsoft Windows XP Tablet PC Edition
  • Microsoft Windows XP Professional x64 Edition
  • Microsoft Windows 2000 Professionnel
  • Microsoft Windows 2000 Server
  • Microsoft Windows 2000 Advanced Server
  • Microsoft Windows 2000 Datacenter Server
Mots-clés : 
kbhowto kbinfo KB927745
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.
 

Traductions disponibles