Compartilhar via


SPFILENOTIFY_ENDREGISTRATION mensagem

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