Função SetupDefaultQueueCallbackA (setupapi.h)

  • Artigo

[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 SetupDefaultQueueCallback é a rotina de retorno de chamada de fila padrão incluída na API de Instalação. Você pode usá-lo para processar notificações enviadas pela função SetupCommitFileQueue .

Sintaxe

WINSETUPAPI UINT SetupDefaultQueueCallbackA(
  [in] PVOID    Context,
  [in] UINT     Notification,
  [in] UINT_PTR Param1,
  [in] UINT_PTR Param2
);

Parâmetros

[in] Context

Ponteiro para o contexto inicializado pelas funções SetupInitDefaultQueueCallback ou SetupInitDefaultQueueCallbackEx .

[in] Notification

Notificação de uma ação de fila. Este parâmetro poderá ser um dos valores mostrados na tabela a seguir.

Valor Significado
SPFILENOTIFY_STARTQUEUE
 Iniciou operações de arquivo na fila.
SPFILENOTIFY_ENDQUEUE
 Operações de arquivo enfileiradas concluídas.
SPFILENOTIFY_STARTSUBQUEUE
 Iniciou uma subconsulta de cópia, renomeação ou exclusão.
SPFILENOTIFY_ENDSUBQUEUE
 Terminou uma subconsulta de cópia, renomeação ou exclusão.
SPFILENOTIFY_STARTRENAME
 Iniciou uma operação de renomeação.
SPFILENOTIFY_ENDRENAME
 Terminou uma operação de renomeação.
SPFILENOTIFY_RENAMEERROR
 Encontrou um erro ao renomear um arquivo.
SPFILENOTIFY_STARTDELETE
 Iniciou uma operação de exclusão.
SPFILENOTIFY_ENDDELETE
 Terminou uma operação de exclusão.
SPFILENOTIFY_DELETEERROR
 Encontrou um erro ao excluir um arquivo.
SPFILENOTIFY_STARTCOPY
 Iniciou uma operação de cópia.
SPFILENOTIFY_ENDCOPY
 Terminou uma operação de cópia.
SPFILENOTIFY_COPYERROR
 Encontrou um erro ao copiar um arquivo.
SPFILENOTIFY_NEEDMEDIA
 Novas mídias são necessárias.
SPFILENOTIFY_LANGMISMATCH
 O arquivo de destino existente está em um idioma diferente da origem.
SPFILENOTIFY_TARGETEXISTS
 O arquivo de destino existe.
SPFILENOTIFY_TARGETNEWER
O arquivo de destino existente é mais recente que a origem.

[in] Param1

Informações adicionais da mensagem. O conteúdo desse parâmetro depende do valor do parâmetro Notification .

[in] Param2

Informações adicionais da mensagem. O conteúdo desse parâmetro depende do valor do parâmetro Notification .

Retornar valor

Retorna um inteiro sem sinal para SetupCommitFileQueue que pode ser um dos valores mostrados na tabela a seguir.

Código de retorno Descrição
FILEOP_ABORT
 Anula a operação.
FILEOP_DOIT
 Executa a operação de arquivo.
FILEOP_SKIP
 Ignora a operação.
FILEOP_RETRY
 Tenta novamente a operação.
FILEOP_NEWPATH
 Obtém um novo caminho para a operação.
 

Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função SetupDefaultQueueCallback geralmente é chamada explicitamente por uma rotina de retorno de chamada de fila personalizada. O retorno de chamada personalizado manipula um subconjunto das notificações de confirmação de fila e chama a função SetupDefaultQueueCallback para lidar com o restante das notificações.

Para obter mais informações, consulte Notificações de fila.

Observação

O cabeçalho setupapi.h define SetupDefaultQueueCallback 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
Conjunto de APIs ext-ms-win-setupapi-classinstallers-l1-1-2 (introduzido no Windows 10, versão 10.0.14393)

Confira também

Funções

Visão geral

SetupCommitFileQueue