SPFILENOTIFY_STARTREGISTRATION mensagem

  • Artigo

Ao usar a diretiva INF RegisterDlls para registrar DLLs automaticamente, os chamadores de SetupInstallFromInfSection podem receber notificações em cada arquivo, pois estão registrados ou não registrados. Para enviar uma notificação de SPFILENOTIFY_STARTREGISTRATION para a rotina de retorno de chamada uma vez antes de registrar 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_STARTREGISTRATION.

SPFILENOTIFY_STARTREGISTRATION
  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. O membro FileName deve ser definido como o caminho totalmente qualificado do arquivo que está sendo registrado. Win32Error não é usado e deve ser definido como NO_ERROR. FailureCode não é usado e deve ser definido como SPREG_SUCCESS.

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
 Não registre ou cancele o registro do arquivo e pare de processar a seção INF.
FILEOP_DOIT
 Registre ou cancele o registro do arquivo e continue processando a seção INF.
FILE_SKIP
 Ignorar o registro ou cancelar o registro do arquivo, mas 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_ENDREGISTRATION