Função SetupInitDefaultQueueCallbackEx (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 SetupInitDefaultQueueCallbackEx inicializa o contexto usado pela rotina de retorno de chamada de fila padrão incluída na API de Instalação da mesma maneira que SetupInitDefaultQueueCallback, exceto que uma janela adicional é fornecida à função de retorno de chamada para aceitar mensagens de progresso.
Sintaxe
WINSETUPAPI PVOID SetupInitDefaultQueueCallbackEx(
[in] HWND OwnerWindow,
[in] HWND AlternateProgressWindow,
[in] UINT ProgressMessage,
[in] DWORD Reserved1,
[in] PVOID Reserved2
);
Parâmetros
[in] OwnerWindow
Manipule para a janela a ser usada como pai de qualquer caixa de diálogo gerada pela rotina de retorno de chamada padrão.
[in] AlternateProgressWindow
Manipule para uma janela que recebe as mensagens de progresso. Para impedir que mensagens de progresso sejam exibidas, você pode especificar esse parâmetro para ser INVALID_HANDLE_VALUE.
[in] ProgressMessage
Mensagem enviada para AlternateProgressWindow quando a fila de cópia é iniciada e cada vez que um arquivo é copiado.
[in] Reserved1
Primeiro parâmetro de mensagem que é enviado para o AlternateProgressWindow pela rotina de retorno de chamada padrão.
[in] Reserved2
Segundo parâmetro de mensagem que é enviado para o AlternateProgressWindow pela rotina de retorno de chamada padrão.
Valor retornado
SetupInitDefaultQueueCallbackEx retorna um ponteiro para o contexto usado pela rotina de retorno de chamada de fila padrão. Essa função só poderá falhar se não houver memória suficiente. Se essa função falhar, ela retornará NULL e não definirá o código de último erro para o thread.
Comentários
Quando a fila começa a confirmar a subconsulta de cópia, a rotina de retorno de chamada de fila padrão envia uma mensagem para a janela especificada em AlternateProgressWindow. Reserved1 tem o valor 0 e Reserved2 contém um ponteiro para o número de operações de cópia de arquivo enfileiradas.
Para cada operação de cópia de arquivo concluída, a rotina de retorno de chamada de fila padrão envia uma mensagem para AlternateProgressWindow, que pode ser usada para 'marcar' a barra de progresso. Reserved1 tem o valor 1 e Reserved2 é zero.
SetupInitDefaultQueueCallbackEx pode ser usado para obter o comportamento padrão de solicitação de disco, tratamento de erros e assim por diante, além de fornecer um medidor inserido em uma página do assistente ou em outra caixa de diálogo especializada.
Independentemente de você ter inicializado o contexto usado pela rotina de retorno de chamada de fila padrão com SetupInitDefaultQueueCallback ou SetupInitDefaultQueueCallbackEx, depois que as operações enfileiradas tiverem terminado o processamento, chame SetupTermDefaultQueueCallback para liberar os recursos alocados na inicialização da estrutura de contexto. Para obter mais informações, consulte Inicializando e encerrando o contexto de retorno de chamada.
Requisitos
| 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 |
| Conjunto de APIs | ext-ms-win-setupapi-classinstallers-l1-1-2 (introduzido no Windows 10, versão 10.0.14393) |