Função SetupDefaultQueueCallbackA (setupapi.h)

Artigo
11/20/2024

[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 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 na fila 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.

Valor de retorno

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	Repete a operação.
FILEOP_NEWPATH	Obtém um novo caminho para a operação.

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

Observações

A função SetupDefaultQueueCallback geralmente é chamada apenas 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.

Nota

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 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
conjunto de API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introduzido no Windows 10, versão 10.0.14393)

Consulte também

Funções

Visão geral

SetupCommitFileQueue

Compartilhar via