Função SetupCommitFileQueueA (setupapi.h)
[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. SetupAPI não deve mais ser usado para instalar aplicativos. Em vez disso, use o Windows Installer para desenvolver instaladores de aplicativos. SetupAPI continua a ser usado para instalar drivers de dispositivo.]
A função SetupCommitFileQueue executa operações de arquivo enfileiradas em uma fila de arquivos de instalação.
A melhor prática é coletar todas as operações de arquivo necessárias para a fila de arquivos e confirmar a fila apenas uma vez porque uma fila de arquivos não pode ser reutilizado depois de confirmada. Se o processamento adicional da fila for necessário depois de confirmada, o identificador para a fila deverá ser fechado e uma nova fila de arquivos será criada. Para obter mais informações, consulte Confirmando uma fila.
Se um arquivo for modificado, o chamador dessa função precisará ter privilégios para gravar no diretório de destino.
Sintaxe
WINSETUPAPI BOOL SetupCommitFileQueueA(
[in] HWND Owner,
[in] HSPFILEQ QueueHandle,
[in] PSP_FILE_CALLBACK_A MsgHandler,
[in] PVOID Context
);
Parâmetros
[in] Owner
Identificador opcional para uma janela a ser usada como o pai de qualquer caixa de diálogo de progresso.
[in] QueueHandle
Manipular para uma fila de arquivos de instalação, conforme retornado por SetupOpenFileQueue.
[in] MsgHandler
Ponteiro para uma rotina de retorno de chamada opcional para ser notificado sobre vários eventos significativos que estão no processamento da fila. Para obter mais informações, consulte padrão de rotina de retorno de chamada de fila ou FileCallback se a rotina de retorno de chamada for nulo, SetupCommitFileQueue retornará VERDADEIRO e o erro for 0 ou NO_ERROR.
[in] Context
Valor passado para a função de retorno de chamada fornecida pelo parâmetro msgHandler. Se a rotina de retorno de chamada padrão tiver sido especificada como MsgHandler, esse contexto deverá ser o contexto retornado de SetupInitDefaultQueueCallback ou SetupInitDefaultQueueCallbackEx.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
A rotina de retorno de chamada especificada em msgHandler deve ser compatível com os parâmetros que SetupCommitFileQueue passado para ele durante uma confirmação de fila.
Se o Unicode for definido em seu aplicativo de retorno de chamada e você especificar msgHandler como a rotina de retorno de chamada de fila padrão, a rotina de retorno de chamada esperará parâmetros Unicode. Caso contrário, a rotina de retorno de chamada de fila padrão esperará parâmetros ANSI.
Nota
O cabeçalho setupapi.h define SetupCommitFileQueue como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | setupapi.h |
| biblioteca | Setupapi.lib |
| de DLL |
Setupapi.dll |