ID do artigo: 927745 - �ltima revis�o: ter�a-feira, 13 de fevereiro de 2007 - Revis�o: 2.4

Informa��es detalhadas para os desenvolvedores que usam o arquivo de verifica��o offline do Windows Update

Exibir os produtos aos quais esse artigo se aplica.

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que est� a utilizar. Foi desactivado o conte�do do artigo, que pode n�o ser relevante para si.

Em novembro de 2006, uma nova vers�o do arquivo de verifica��o offline do Windows Update (WU) foi lan�ada com o arquivo de verifica��o offline existente do Windows Update, o Wsusscan.cab. O novo arquivo de verifica��o offline, Wsusscn2.cab, tem um novo formato. Todas as solu��es de verifica��o que usam o arquivo de verifica��o offline existente do Windows Update devem ser atualizadas para o novo arquivo de mar�o de 2007.

Toda solu��o que n�o seja Microsoft e que usa o arquivo de verifica��o offline do Windows Update dever ter o WUA (Agente do Windows Update) instalado para todos os sistemas operacionais do Microsoft Windows 2000, do Microsoft Windows XP e do Microsoft Windows Server 2003. Os computadores que t�m o Windows Vista instalado ter�o o WUA atualizado nos lan�amentos do sistema operacional. Por isso, o Windows Vista n�o precisar� de uma atualiza��o.

Algumas solu��es n�o Microsoft que usam o arquivo de verifica��o offline do Windows Update, na detec��o da atualiza��o de seguran�a offline, tamb�m dever�o ser atualizadas. Estas solu��es necessitam das vers�es atualizadas do arquivo de verifica��o offline do Windows Update se os arquivos forem lidos em vez de usarem o Windows Update API. N�o � aconselh�vel que estas solu��es leiam o arquivo diretamente, pois o arquivo est� sujeito a altera��es. Em vez disto, � aconselh�vel que os desenvolvedores usem o recurso de verifica��o offline do WUA. Para obter informa��es sobre esse recurso, visite o seguinte site da MSDN (em ingl�s):

http://msdn2.microsoft.com/en-us/library/aa387099.aspx (http://msdn2.microsoft.com/en-us/library/aa387099.aspx)

Voltar para o in�cio

Mais Informa��es

A Microsoft alterou o formato interno do arquivo de verifica��o offline do Windows Update para solucionar o problema explicado no artigo 926464 da Base de Dados de Conhecimento Microsoft. Toda solu��o n�o Microsoft que acesse este arquivo de maneira n�o documentada na API p�blica pode solicitar o arquivo atualizado.

Todos os produtos, ferramentas e solu��es que usam o arquivo Wsusscan.cab, usando a API do WUA documentada, devem ser atualizados at� mar�o de 2007. Estes produtos, ferramentas e solu��es devem ser capazes de usar o novo arquivo Wsusscn2.cab para baix�-lo da nova localiza��o. Alem disso, todos os computadores cliente devem ter a vers�o atualizada necess�ria do computador cliente WUA instalada. Todas as solu��es Microsoft, que acessam o arquivo CAB diretamente, podem precisar de altera��es adicionais devido a altera��es de formato interno.

Voltar para o in�cio

Acessar diretamente o arquivo Wsusscn2.cab

N�o � aconselh�vel acessar o arquivo Wsusscn2.cab, pois � prov�vel que o formato seja alterado. No entanto, este arquivo inclui informa��es para os desenvolvedores que t�m as solu��es existentes que acessam diretamente o arquivo.

Voltar para o in�cio

Determinar se a vers�o do WUA � a correta para o arquivo Wsusscn2.cab

Se a vers�o do WUA instalada no computador n�o atender os requisitos m�nimos de vers�o do formato do pacote de verifica��o correspondente, a vers�o instalada do WUA n�o ir� funcionar com o pacote de verifica��o e poder� retornar o WU_E_OL_NEWCLIENT_REQUIRED e outros c�digos HRESULT de seu pacote de verifica��o das APIs relacionadas. No pior caso, a vers�o instalada da API WUA pode n�o ser compat�vel com nenhuma funcionalidade relacionada do pacote de verifica��o. Por exemplo, o API WUA pode n�o ser compat�vel com a interface IUpdateServiceManager. Para obter informa��es sobre como evitar este comportamento, visite o seguinte site (em ingl�s):

http://msdn2.microsoft.com/en-us/library/aa387099.aspx (http://msdn2.microsoft.com/en-us/library/aa387099.aspx)

Essas informa��es ajudar�o na compreens�o de como o aplicativo pode configurar a vers�o posterior do WUA no computador.

O aplicativo pode configurar a vers�o posterior do WUA no computador antes de usar os pacotes de verifica��o com o API WUA. Para obter informa��es sobre como usar os pacotes de verifica��o para examinar as atualiza��es em um ambiente offline, visite o seguinte site (em ingl�s):

http://msdn2.microsoft.com/en-us/library/aa387290.aspx (http://msdn2.microsoft.com/en-us/library/aa387290.aspx)

Para obter mais informa��es sobre a interface IUpdateCollection, visite o seguinte site (em ingl�s):

http://msdn2.microsoft.com/en-us/library/aa386107.aspx (http://msdn2.microsoft.com/en-us/library/aa386107.aspx)

Para obter mais informa��es sobre o pacote de verifica��o, visite o seguinte site (em ingl�s):

http://msdn2.microsoft.com/en-us/library/aa386821.aspx (http://msdn2.microsoft.com/en-us/library/aa386821.aspx)

Para obter mais informa��es sobre o API WUA, visite o seguinte site (em ingl�s):

http://msdn2.microsoft.com/en-us/library/aa387099.aspx (http://msdn2.microsoft.com/en-us/library/aa387099.aspx)

Voltar para o in�cio

Altera��es no formato de arquivo CAB

O arquivo Wsusscan.cab cont�m um �nico arquivo CAB. Este arquivo � Package.cab. O arquivo Wsusscn2.cab cont�m os seguintes arquivos:

Um arquivo Index.xml. Este arquivo cont�m os seguintes componentes:
- Elemento <Index>
  Atributo de vers�o (n�mero)
  Necess�rio? Sim
  Significado: O n�mero de vers�o que usa o formato do arquivo Index.xml
  Coment�rios: Esse valor tem de ser numericamente equivalente a Vers�o="1"
- Elemento<CabList>
  Atributo Xor (n�mero)
  Necess�rio? N�o
  Valor padr�o: Xor="0"
  Significado:
  - Xor="1" indica que todos os arquivos CAB definidos pelos elementos <Cab> filhos, exceto o arquivo Package.cab, foram obstru�dos por uma opera��o N�O bitwise. Em outras palavras, todos os arquivos CAB definidos, exceto o arquivo Package.cab, t�m 1s e 0s em todos os bits dos conte�dos movidos. Este comportamento ocorre para melhorar o desempenho do WUA no processamento do pacote de verifica��o, ignorando o tempo que alguns antiv�rus de computadores cliente levam para examinar os arquivos CAB em busca de v�rus.
  - Xor="0" indica que todos os arquivos CAB definidos pelos elementos <Cab> filhos n�o s�o obstru�dos por uma opera��o N�O bitwise.
- Elemento <Cab>
  Atributo de nome (seq��ncia)
  Necess�rio? Sim
  Significado: O nome do arquivo CAB definido pelo elemento <Cab>.
  Coment�rios:
  - O valor do primeiro elemento <Cab> definido em <CabList> deve ser Package.cab.
    
    Observa��o Esse valor diferencia mai�sculas de min�sculas.
  - Normalmente, se o valor for Xor="1", os arquivos CAB, definidos como segundo, terceiro e assim por diante pelos elementos <Cab>, ser�o chamados Package2.wu, Package3.wu, e assim por diante. Isto � verdade se os elementos estiverem presentes.
  - Normalmente, se o valor for Xor="0", os arquivos CAB, definidos como segundo, terceiro e assim por diante pelos elementos <Cab>, ser�o chamados Package2.cab, Package3.cab e assim por diante. Isto � verdade se os elementos estiverem presentes.
  Atributo RangeStart (n�mero)
  Necess�rio? N�o para o arquivo Package.cab, sim para o arquivo PackageVersionNumber arquivo .wu
  Padr�o: (nenhum)
  Significado:
  - Os arquivos RevisionId espec�ficos s�o os arquivos nas pastas C, E, I e X. Estes arquivos podem transpor mais de um dos arquivos CAB definidos no elemento <CabList>. No entanto, as especifica��es Wsusscn2.cab necessitam que todos os arquivos espec�ficos a um determinado RevisionId devem ser armazenados em apenas um arquivo CAB. O atributo RangeStart registra o menor valor RevisionId dos arquivos RevisionId espec�ficos contidos no arquivo CAB correspondente ao elemento <Cab>.
  - Um valor do atributo n�o encontrado significa que nenhum arquivo RevisionId espec�fico est� armazenado no arquivo CAB correspondente. O elemento <Cab> do arquivo Package.cab normalmente n�o especifica uma valor do atributo RangeStart.
  Coment�rios:
  - Se o valor do atributo RangeStart estiver presente no primeiro elemento <Cab> listado no arquivo Index.xml, ele dever� ser "0".
  - Se os valores do atributo RangeStart definidos nos elementos <Cab> estiverem presentes no arquivo Index.xml file, eles ter�o de estar em uma ordem crescente e n�o dever�o se sobrepor.
  - Ao combinar os valores do atributo RangeStart definido nos elementos <Cab> do arquivo Index.xml, o aplicativo pode deduzir do intervado do RevisionIds cont�nuo e sem sobreposi��o coberto por cada um dos arquivos CAB. O arquivo CAB, que corresponde ao �ltimo elemento <Cab> definido, tem um valor do atributo RangeStart que cont�m todos os arquivos RevisionId espec�ficos, come�ando pelo valor RevisionId especificado no valor do atributo.
- Atributo FilesDir (n�mero)
  Necess�rio: N�o
  Padr�o: FilesDir="0"
  Significado:
  - FilesDir="1" indica que o arquivo CAB correspondente ao elemento <Cab> cont�m a pasta Arquivos.
  - FilesDir="0" indica que o arquivo CAB correspondente ao elemento <Cab> n�o cont�m a pasta Arquivos.
  Observa��o H� apenas um elemento <Cab> que especifica FilesDir="1".
Um arquivo Package.cab ou PackageVersionNumber.wu. Estes arquivos cont�m os seguintes componentes:
- Package.xml
  O arquivo Package.xml est� no mesmo formato e esquema do arquivo Package.cab que est� no arquivo Wsusscan.cab. Assim como no formato mais antigo, o arquivo permanece no arquivo Package.cab.
- A pasta C
  A pasta C cont�m o mesmo tipo de conte�do da pasta principal do arquivo Package.cab, localizado na pasta Wsusscan.cab. Diferentemente do formato mais antigo, a pasta C transp�e um ou mais arquivos CAB Package.cab ou PackageVersionNumber.wu. Este comportamento ocorre pelos valores do atributo RangeStart nos elementos <Cab> correspondentes definidos no arquivo Index.xml.
- A pasta E
  A pasta E cont�m o mesmo tipo de conte�do da pasta Eula de Package.cab no arquivo Wsusscan.cab. Diferentemente do formato mais antigo, a pasta E transp�e um ou mais arquivos CAB Package.cab ou PackageVersionNumber.wu, pelos valores do atributo RangeStart nos elementos <Cab> correspondentes. Estes elementos est�o definidos no arquivo Index.xml.
- A pasta Arquivos
  A pasta Arquivo cont�m o mesmo tipo de conte�do da pasta Arquivos no Package.cab em Wsusscan.cab. Diferentemente do formato mais antigo, a pasta est� armazenada em um �nico arquivo CAB Package.cab ou PackageVersionNumber.wu. Este comportamento ocorre pelo valor do atributo FilesDir que est� no elemento <Cab> correspondente. Este elemento est� no arquivo Index.xml.
- A pasta I
  A pasta I cont�m o mesmo tipo de conte�do da pasta Localizada do arquivo Package.cab, localizado na pasta Wsusscan.cab. A �nica diferen�a � que os arquivos que correspondem �s atualiza��es do software n�o implement�veis explicitamente e n�o agrupadas est�o no Wsusscn2.cab para fins de desempenho do computador do usu�rio final. As propriedades localizadas removidas para essas atualiza��es s�o gerados automaticamente pelo WUA durante o tempo de execu��o. Diferentemente do formato mais antigo, a pasta transp�e um ou mais arquivos CAB Package.cab ou PackageVersionNumber.wu, pelos valores do atributo RangeStart nos elementos <Cab> correspondentes. Estes elementos est�o definidos no arquivo Index.xml.
- A pasta X
  A pasta X cont�m o mesmo tipo de conte�do da pasta estendida de Package.cab no arquivo Wsusscan.cab. Diferentemente do formato mais antigo, a pasta X transp�e um ou mais arquivos CAB Package.cab ou PackageVersionNumber.wu. Este comportamento ocorre pelos valores do atributo RangeStart que est� no elemento <Cab> correspondente. Estes elementos est�o definidos no arquivo Index.xml.