Wceload Tool

9/8/2008

A ferramenta Wceload (Wceload.exe), que é um aplicativo instalador CAB XML-Based, é executado em seu dispositivo destino. Você geralmente usar essa ferramenta para instalar um arquivo .cab ou .CPF para uma localidade que você selecionar no dispositivo de destino. A maioria dos arquivos .cab estão configurados para habilitar o usuário para selecionar o volume destino onde o arquivo .cab será instalado, o \Device ou \Storage placa. No entanto, você pode escolher para suprimir a seleção volume destino prompt e instalar o .cab arquivo para uma localidade usar como padrão, especificada no arquivo .inf usado para criar o arquivo CAB.

Normalmente, você fazer não diretamente chamar Wceload. Em vez disso, Wceload é chamado programaticamente por outros programas para instalar arquivos .cab. De exemplo, se você usar File Explorer para exibição e aberto um arquivo .cab, Shell automaticamente invoca Wceload para instalação do arquivo CAB.

Para obter informações sobre como criar um arquivo .cab, consulte CAB Files for Delivering Windows Mobile Applications.

Wceload implementa os mecanismos de segurança e executa tarefas instalação para os arquivos .cab e .CPF em dispositivos Windows Mobile powered.

Wceload instala arquivos .cab e .CPF usando o seguinte processo:

1. Wceload recebe um arquivo .cab ou .CPF por meio de um dos mecanismos de entrega. Enquanto ActiveSync pode enviar múltiplo arquivos .cab ou .CPF em um lote, cada arquivo é processado por sua vez.
2. Se o arquivo é assinado, Wceload tenta verificar o Certificado incluído contra certificados colocado na SPC Store.
3. Se o arquivo .cab é sem assinatura, a função de segurança a ser usado para a instalação é determinada pelas diretivas de segurança SECPOLICY_UNSIGNEDCABS e SECPOLICY_UNSIGNEDPROMPT.
4. Após o Certificado processo verificação ocorre, Wceload abre o arquivo .cab para instalações permitidas e extrai o arquivo incluído _setup.xml, que é passado para o Configuration Manager para processamento.

Para obter informações sobre como criar arquivos CAB, consulte CAB Wizard.

Syntax

wceload.exe [ /delete <number> | /noui ] [ /confignotify | /nodelete | /safe | /silent | /verifyconfig] <cab file location>

Parameters

• /confignotify
  Gera uma notificação resultado configuração que é colocada na armazenar Text Message sobre o dispositivo.

• /nodelete
  Especifica que o arquivo .cab não é removido após instalação.

  Observação

  Se você não especificar /nodelete Ou /delete 0 quando execução Wceload, o arquivo .cab será excluído, mesmo se a instalação não é bem-sucedido.

• /delete < número >
  Especifica como Wceload remove o arquivo cab após instalação.

  Observação

  Se você não especificar /nodelete Ou /delete 0 quando execução Wceload, o arquivo .cab será excluído, mesmo se a instalação não é bem-sucedido.

  Valor	Descrição
  0	Não remover o arquivo .cab depois que o conteúdo forem instalado.
  1	Remove o arquivo .cab depois que o conteúdo forem instalado. Este é o valor usar como padrão.

• /noui
  Especifica que o usuário não será solicitado para qualquer entrada durante a instalação. Por padrão, avisos são respondidos com 'Sim'.

  No entanto, se o arquivo .cab é sem assinatura, qualquer segurança-relacionado solicita será usar como padrão para 'Não' Para segurança razões e a instalação podem falhar.

  Este é o mesmo que / silencioso Para herdado razões compatibilidade.

• / Seguro
  Especifica que o arquivo .cab não pode conter arquivos executáveis. Também; Se o arquivo .cab é sem assinatura; Ele só pode usar permissões restritas, garantindo que ele não poderá gravar arquivos protegidos e as chaves Registro.

• / silencioso
  Suprime caixas diálogo durante a instalação e todos os Sim/Não solicita que usar como padrão para 'Sim', a menos que o arquivo .cab não esteja assinado. No entanto, se o arquivo .cab é sem assinatura, qualquer segurança-relacionado solicita será usar como padrão para 'Não' Para segurança razões e a instalação podem falhar.

  Este é o mesmo que /noui Para herdado razões compatibilidade.

• /verifyconfig
  Especifica que a ferramenta Wceload deve verificar se o arquivo passado é um arquivo .CPF. Se o arquivo não for um arquivo .CPF, a instalação falhará.

• localidade arquivo cab
  Especifica a localidade do arquivo cab para instalar ou remover.

Remarks

Em Windows Mobile Version 5.0 e posterior, ao usar Wceload.exe para reinstalar um arquivo .cab, Wceload.exe desinstala a versão instalada anteriormente do arquivo .cab antes de instalar a nova versão. Durante a parte de desinstalação desse processo, Wceload.exe fecha qualquer atualmente execução executáveis que foram instalados no dispositivo de destino usando um arquivo .cab, com base em suas nome do arquivo. Wceload.exe também fecha os executáveis que são o destino de uma operação do arquivo, such as um mover ou copiar um. Para fechar um arquivo executável, Wceload.exe envia WM_CLOSE para de alto nível todas as janelas pertencentes o processo. Se o processo não sair em tempo hábil após receber a mensagem WM_CLOSE, em seguida, Wceload.exe forçosamente por chamado fecha TerminateProcess. Wceload.exe não tenta fechar arquivos executáveis que vêm na executar-imagem tempo no dispositivo de destino.

Se o arquivo .cab não for assinado e você especificar a / silencioso Ou /noui Opções quando chamado wceload, wceload pode ignorar essas opções.

O seguinte exemplo de código mostra como chamar Wceload.exe para instalar um MyCabFile.cab, arquivo chamado .cab enquanto eliminando todas as caixas diálogo durante a instalação. Após instalação, o arquivo .cab especificamente não é removido.

Example

wceload /nodelete /silent "\Temp\MyCabFile.cab"

See Also

Concepts

CAB Files for Delivering Windows Mobile Applications

Other Resources

CAB Wizard
Information File