SPFILENOTIFY_ENDREGISTRATION mensagem

Artigo
06/12/2023

Ao usar a diretiva INF RegisterDlls para registrar DLLs automaticamente, os chamadores de SetupInstallFromInfSection podem receber notificações em cada arquivo à medida que estiverem registrados ou não registrados. Para enviar uma notificação SPFILENOTIFY_ENDREGISTRATION para uma rotina de retorno de chamada uma vez depois de registrar ou cancelar o registro de um arquivo, inclua SPINST_REGISTERCALLBACKAWARE mais SPINST_REGSVR no parâmetro Flags de SetupInstallFromInfSection. Para enviar notificação de cancelamento do registro, inclua SPINST_REGISTERCALLBACKAWARE mais SPINST_UNREGSVR no parâmetro Flags .

A rotina de retorno de chamada especificada pelo parâmetro MsgHandler de SetupInstallFromInfSection deve ser do tipo PSP_FILE_CALLBACK. Defina o parâmetro Context como o mesmo Contexto especificado em SetupInstallFromInfSection. Defina o parâmetro Notification como SPFILENOTIFY_ENDREGISTRATION.

SPFILENOTIFY_ENDREGISTRATION
  Param1 = (UINT_PTR) pointer to file information;
  Param2 = (UINT_PTR) file registration or unregistration;

Parâmetros

Param1: Ponteiro para uma estrutura SP_REGISTER_CONTROL_STATUS que contém informações sobre o arquivo que está sendo registrado ou não registrado. O membro cbsize deve ser definido como o tamanho da estrutura. FileName deve ser definido como o caminho totalmente qualificado do arquivo que está sendo registrado. Win32Error deve ser definido como um código de erro do sistema que indica um código de erro estendido. FailureCode deve ser definido como um dos códigos de falha válidos que indicam o resultado do registro. Para obter códigos de falha válidos , consulte SP_REGISTER_CONTROL_STATUS.
Param2: Se o arquivo estiver sendo registrado, Param2 deverá ser definido como um ponteiro para um valor diferente de zero. Se o arquivo estiver sendo cancelado, Param2 deverá ser definido como um ponteiro como zero.

Valor retornado

Depois de receber a notificação, a função de retorno de chamada pode retornar um dos valores a seguir.

Código de retorno	Descrição
FILEOP_ABORT	Pare de processar a seção INF.
FILEOP_DOIT	Continue processando a seção INF.
FILE_SKIP	Continuar processando a seção INF

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]
Cabeçalho	Setupapi.h

Confira também

Visão geral
Notificações
SetupInstallFromInfSection
SPFILENOTIFY_STARTREGISTRATION