Função SetupDefaultQueueCallbackA (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 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. Esse parâmetro pode 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 só é 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

   
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 em Windows 10, versão 10.0.14393)

Confira também

Funções

Visão geral

SetupCommitFileQueue