Sobre a solicitação de disco e o tratamento de erros

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

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ção SetupPromptForDisk 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 ao 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, SetupRenameError e SetupDeleteError, criam caixas de diálogo que interagem com o usuário para coletar informações do usuário sobre como proceder quando ocorreu 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 anular.

A função SetupDeleteError gera uma caixa de diálogo que pode coletar entradas 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 anular.

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 lidar com erros e solicitar novas mídias.