SPFILENOTIFY_STARTREGISTRATION mensagem
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 |
|---|---|
|
Não registre ou cancele o registro do arquivo e pare de processar a seção INF. |
|
Registre ou cancele o registro do arquivo e continue processando a seção INF. |
|
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 |
|