Função SetupCommitFileQueueA (setupapi.h)
[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele poderá ser alterado ou ficar 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 que ela tiver sido 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
Manipule para uma fila de arquivos de instalação, conforme retornado por SetupOpenFileQueue.
[in] MsgHandler
Ponteiro para uma rotina de retorno de chamada opcional a ser notificada de vários eventos significativos que estão no processamento da fila. Para obter mais informações, consulte Rotina de retorno de chamada de fila padrão ou FileCallback Se a rotina de retorno de chamada for nula, SetupCommitFileQueue retornará TRUE e o erro será 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.
Retornar valor
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.
Comentários
A rotina de retorno de chamada especificada em MsgHandler deve ser compatível com os parâmetros que SetupCommitFileQueue passou para ela durante uma confirmação de fila.
Se 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.
Observação
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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | setupapi.h |
| Biblioteca | Setupapi.lib |
| DLL | Setupapi.dll |