Artigo: 927745 - �ltima revis�o: ter�a-feira, 13 de Fevereiro de 2007 - Revis�o: 2.4

Informa��es detalhadas para programadores que utilizam o ficheiro de verifica��o offline do Windows Update

Ver produtos para os quais este 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, foi disponibilizada uma nova vers�o do ficheiro de verifica��o offline do Windows Update (WU), em conjunto com o ficheiro de verifica��o offline existente do WU, Wsusscan.cab. O novo ficheiro de verifica��o offline do WU, Wsusscn2.cab, tem um novo formato. Todas as solu��es de verifica��o que utilizem o ficheiro de verifica��o offline existente do WU t�m de ser actualizadas de forma a utilizarem o novo ficheiro, at� Mar�o de 2007.

Todas as solu��es n�o-Microsoft que utilizem o ficheiro de verifica��o offline do WU t�m de ter o programa de instala��o aut�nomo do Windows Update Agent (WUA) actualizado instalado para todos os sistemas operativos Microsoft Windows 2000, Microsoft Windows XP e Microsoft Windows Server 2003. Computadores que tenham o Windows Vista instalado ter�o o WUA actualizado quando o sistema operativo for lan�ado. Por este motivo, o Windows Vista n�o necessitar� de actualiza��o.

Algumas solu��es n�o-Microsoft que utilizem o ficheiro de verifica��o offline do WU para detec��o de actualiza��es de seguran�a offline poder�o tamb�m necessitar da vers�o actualizada. Estas solu��es necessitam desta vers�o actualizada do ficheiro de verifica��o offline do WU se efectuarem a leitura deste ficheiro em vez de utilizarem a API do Windows Update. N�o recomendamos que estas solu��es leiam este ficheiro directamente porque este est� sujeito a altera��es. Em vez disso, recomendamos que os programadores utilizem a funcionalidade de verifica��o offline do WUA. Para obter informa��es sobre esta funcionalidade, visite o seguinte Web site da MSDN:

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

Voltar ao topo

Mais Informa��o

A Microsoft alterou o formato interno do ficheiro de verifica��o offline do WU para resolver o problema explicado no artigo 926464 da base de dados de conhecimento da Microsoft (KB, Microsoft Knowledge Base). Todas as solu��es n�o-Microsoft que acedam a este ficheiro de formas n�o documentadas na API p�blica poder�o necessitar do ficheiro actualizado.

Todos os produtos, ferramentas e solu��es que utilizem o ficheiro Wsusscan.cab utilizando a API do WUA documentada ter�o de ser actualizados at� Mar�o de 2007. Estes produtos, ferramentas e solu��es t�m de conseguir utilizar o novo ficheiro Wsusscn2.cab para transferir o ficheiro Wsusscn2.cab a partir da nova localiza��o. Al�m disso, todos os computadores cliente t�m de ter instalada a vers�o de computador cliente do WUA actualizada necess�ria. Todas as solu��es Microsoft que acedam ao ficheiro CAB directamente poder�o necessitar de altera��es adicionais devido �s altera��es no formato interno.

Voltar ao topo

Aceder directamente ao ficheiro Wsusscn2.cab

N�o recomendamos o acesso directo ao ficheiro Wsusscn2.cab porque o formato do ficheiro est� sujeito altera��es. No entanto, este artigo inclui informa��es para programadores que j� t�m solu��es que acedem directamente ao ficheiro.

Voltar ao topo

Determinar se a vers�o do WUA � a correcta para o ficheiro Wsusscn2.cab

Se a vers�o do WUA instalada no computador n�o satisfizer o requisito m�nimo de vers�o do formato do pacote de verifica��o correspondente, n�o funcionar� com o pacote de verifica��o e poder� devolver WU_E_OL_NEWCLIENT_REQUIRED e outros c�digos HRESULT das respectivas APIs relacionadas com o pacote de verifica��o. No pior dos casos, a vers�o instalada da API do WUA poder� n�o suportar qualquer funcionalidade relacionada com o pacote de verifica��o. Por exemplo, a API do WUA poder� n�o suportar a interface IUpdateServiceManager. Para obter informa��es sobre como evitar este comportamento, visite o seguinte Web site:

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

Estas informa��es ajud�-lo-�o a compreender como a aplica��o poder� instalar a vers�o mais recente do WUA no computador.

A aplica��o poder� instalar a vers�o mais recente do WUA no computador antes de utilizar pacotes de verifica��o com a API do WUA. Para obter informa��es sobre como utilizar pacotes de verifica��o para verificar a exist�ncia de actualiza��es num ambiente offline, visite o seguinte Web site:

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

Para obter informa��es sobre a interface IUpdateCollection, visite o seguinte Web site:

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 Web site:

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

Para obter informa��es sobre a API do WUA, visite o seguinte Web site:

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

Voltar ao topo

Altera��es ao formato do ficheiro CAB

O ficheiro Wsusscan.cab cont�m um �nico ficheiro CAB. Este ficheiro � o Package.cab. O ficheiro Wsusscn2.cab cont�m os seguintes ficheiros:

Um ficheiro Index.xml. Este ficheiro cont�m os seguintes componentes:
- Elemento <Index>
  Atributo Version (n�mero)
  Obrigat�rio? Sim
  Significado: o n�mero de vers�o que utiliza o formato do ficheiro Index.xml
  Coment�rios: este valor tem de ser numericamente equivalente a Version="1"
- Elemento <CabList>
  Atributo Xor (n�mero)
  Obrigat�rio? N�o
  Valor predefinido: Xor="0"
  Significado:
  - Xor="1" indica que todos os ficheiros CAB definidos pelos elementos <Cab> subordinados, excepto o ficheiro Package.cab, foram encobertos por uma opera��o NOT bit a bit. Por outras palavras, todos os ficheiros CAB definidos, excepto o ficheiro Package.cab, t�m os 1s e os 0s de todos os bits do respectivo conte�do invertidos. Este comportamento ocorre para melhorar o desempenho do WUA no processamento do pacote de verifica��o poupando o tempo que software antiv�rus de alguns computadores cliente leva a verificar a exist�ncia de v�rus nesses ficheiros CAB.
  - Xor="0" indica que todos os ficheiros CAB definidos pelos elementos <Cab> subordinados n�o foram encobertos por uma opera��o NOT bit a bit.
- Elemento <Cab>
  Atributo Name (cadeia de caracteres)
  Obrigat�rio? Sim
  Significado: o nome do ficheiro CAB definido pelo elemento <Cab>.
  Coment�rios:
  - O valor do primeiro elemento <Cab> definido em <CabList> tem de ser Package.cab.
    
    Nota: este valor � sens�vel a mai�sculas e min�sculas.
  - Normalmente, se o valor for Xor="1", os ficheiros CAB definidos em segundo, terceiro+++, etc., pelos elementos <Cab> denominados Package2.wu, Package3.wu, e assim sucessivamente. Isto verifica-se se os elementos estiverem presentes.
  - Normalmente, se o valor for Xor="0", the CAB files that are defined second, third, and on by <Cab> elements are named Package2.cab, Package3.cab, and so on.+++ Isto verifica-se se os elementos estiverem presentes.
  Atributo RangeStart (n�mero)
  Obrigat�rio? N�o para o ficheiro Package.cab; sim para o ficheiro PackageN�mero_vers�o.wu
  Predefini��o: (None)
  Significado:
  - Os ficheiros espec�ficos do RevisionId s�o os ficheiros existentes nas pastas C, E, I e X. Estes ficheiros poder�o estar dispersos por mais do que um dos ficheiros CAB definidos no elemento <CabList>. No entanto, as especifica��es do ficheiro Wsusscn2.cab necessitam que todos os ficheiros espec�ficos de um determinado RevisionId estejam guardados num destes ficheiros CAB. O atributo RangeStart regista o menor valor de RevisionId dos ficheiros espec�ficos do RevisionId contidos no ficheiro CAB que corresponde ao elemento <Cab>.
  - Um valor de atributo em falta significa que n�o existem ficheiros espec�ficos do RevisionId guardados no ficheiro CAB correspondente. O elemento <Cab> do ficheiro Package.cab normalmente n�o especifica um valor de atributo RangeStart.
  Coment�rios:
  - Se o valor de atributo RangeStart estiver presente no primeiro elemento <Cab> listado no ficheiro Index.xml, ter� de ser "0".
  - Se os valores de atributo RangeStart definidos nos elementos <Cab> estiverem presentes no ficheiro Index.xml, ter�o de estar por ordem ascendente e n�o podem sobrepor-se.
  - Combinando os valores do atributo RangeStart definidos nos elementos <Cab> do ficheiro Index.xml, a aplica��o consegue deduzir o intervalo de RevisionIds n�o sobrepostos cont�nuos abrangidos por cada um dos ficheiros CAB. O ficheiro CAB que corresponde ao �ltimo elemento <Cab> definido que tenha um valor de atributo RangeStart que contenha todos os ficheiros espec�ficos do RevisionId, a partir do valor de RevisionId especificado no valor do atributo.
- Atributo FilesDir (n�mero)
  Obrigat�rio: N�o
  Predefini��o: FilesDir="0"
  Significado:
  - FilesDir="1" indica que o ficheiro CAB que corresponde ao elemento <Cab> cont�m a pasta Files.
  - FilesDir="0" indica que o ficheiro CAB que corresponde ao elemento <Cab> n�o cont�m a pasta Files.
  Nota: existe apenas um elemento <Cab> que especifica FilesDir="1".
Um ficheiro Package.cab ou um ficheiro PackageN�mero_vers�o.wu. Estes ficheiros cont�m os seguintes componentes:
- Package.xml
  O ficheiro Package.xml tem o mesmo formato e esquema que o ficheiro Package.cab inclu�do no ficheiro Wsusscan.cab. � semelhan�a do formato antigo, o ficheiro permanece no ficheiro Package.cab.
- A pasta C
  A pasta C cont�m o mesmo tipo de conte�do que a pasta Core do ficheiro Package.cab inclu�do no ficheiro Wsusscan.cab. Ao contr�rio do formato antigo, a pasta C est� dispersa por um ou mais ficheiros CAB Package.cab ou PackageN�mero_vers�o.wu. Este comportamento ocorre por valor do atributo RangeStart, definidos nos elementos <Cab> correspondentes, definidos no ficheiro Index.xml.
- A pasta E
  A pasta E cont�m o mesmo tipo de conte�do que a pasta Eula do Package.cab inclu�do no ficheiro Wsusscan.cab. Ao contr�rio do formato antigo, a pasta E est� dispersa por um ou mais ficheiros CAB Package.cab ou PackageN�mero_vers�o.wu, por valor do atributo RangeStart definido nos elementos <Cab> correspondentes. Estes elementos est�o definidos no ficheiro Index.xml.
- A pasta Files
  A pasta File cont�m o mesmo tipo de conte�do que a pasta Files do Package.cab de Wsusscan.cab. Ao contr�rio do formato antigo, a pasta est� armazenada num �nico ficheiro CAB Package.cab ou PackageN�mero_vers�o.wu. Este comportamento ocorre por valor do atributo FilesDir, definido no elemento <Cab> correspondente. Este elemento est� no ficheiro Index.xml.
- A pasta I
  A pasta I cont�m o mesmo tipo de conte�do que a pasta Localized do ficheiro Package.cab inclu�do no ficheiro Wsusscan.cab. A �nica diferen�a consiste no facto de os ficheiros que correspondem �s actualiza��es de software n�o agrupadas de implementa��o n�o expl�cita n�o estarem inclu�dos no ficheiro Wsusscn2.cab, por motivos de desempenho no computador do utilizador final. As propriedades localizadas removidas destas actualiza��es s�o geradas automaticamente pelo WUA durante a execu��o. Ao contr�rio do formato antigo, a pasta est� dispersa por um ou mais ficheiros CAB Package.cab ou PackageN�mero_vers�o.wu, por valor do atributo RangeStart, definidos nos elementos <Cab> correspondentes. Estes elementos est�o definidos no ficheiro Index.xml.
- A pasta X
  A pasta X cont�m o mesmo tipo de conte�do que a pasta Extended do Package.cab inclu�do no ficheiro Wsusscan.cab. Ao contr�rio do formato antigo, a pasta X est� dispersa por um ou mais ficheiros CAB Package.cab ou PackageN�mero_vers�o.wu. Este comportamento ocorre por valor do atributo RangeStart, definidos nos elementos <Cab> correspondentes. Estes elementos est�o definidos no ficheiro Index.xml.