Sobre solicitação de disco e tratamento de erros

Embora as funções de configuração não forneçam uma interface de usuário, existem quatro funções de configuração que geram caixas de diálogo para lidar com situações comuns de instalação e coletar informações do usuário. São eles: SetupPromptForDisk , SetupCopyError , SetupRenameError e SetupDeleteError .

As rotinas de retorno de chamada podem chamar essas funções para criar caixas de diálogo para ajudar no processamento de notificações enviadas por outras funções de instalação, como SetupCommitFileQueue e SetupInstallFile.

A funçãoSetupPromptForDisk solicita que o usuário insira mídia removível, especifique um novo caminho de origem ou cancele a instalação. O aplicativo pode oferecer opções adicionais para o usuário, dependendo dos sinalizadores especificados quando a função é chamada. Isso inclui ignorar o arquivo atual ou procurar um novo caminho de origem.

As três funções, SetupCopyError, SetupRenameErrore SetupDeleteError, criam caixas de diálogo que interagem com o usuário para coletar informações do usuário sobre como proceder quando ocorrer um erro.

A função SetupCopyError gera uma caixa de diálogo que pergunta ao usuário como se recuperar de um erro de cópia. O usuário pode especificar um novo caminho de origem para a operação de cópia ou cancelar a instalação. Dependendo dos sinalizadores especificados durante a chamada para SetupCopyError , o usuário também poderá procurar um novo caminho de origem, exibir detalhes do erro ou ignorar o arquivo atual.

Uma caixa de diálogo que pergunta ao usuário como processar erros que ocorrem durante uma operação de renomeação de arquivo pode ser gerada chamando SetupRenameError. Com essa caixa de diálogo, o usuário tem a oportunidade de repetir a operação, ignorar a operação de renomeação atual ou abortar.

A funçãoSetupDeleteError gera uma caixa de diálogo que pode coletar informações sobre como o usuário deseja lidar com um erro que ocorreu durante uma operação de exclusão de arquivo. O usuário recebe as opções para repetir a operação, ignorar a operação de exclusão atual ou abortar.

A rotina de retorno de chamada de fila padrão, SetupDefaultQueueCallback, usa as quatro funções mencionadas anteriormente para gerar partes de sua interface do usuário e para manipular erros e solicitar novas mídias.