Поделиться через

SPFILENOTIFY_STARTREGISTRATION сообщение

  • Статья

При использовании директивы INF RegisterDlls для самостоятельной регистрации библиотек DLL вызывающие элементы SetupInstallFromInfSection могут получать уведомления о каждом файле по мере его регистрации или отмены регистрации. Чтобы отправить SPFILENOTIFY_STARTREGISTRATION уведомление в подпрограмму обратного вызова один раз перед регистрацией файла, добавьте SPINST_REGISTERCALLBACKAWARE плюс SPINST_REGSVR в параметр Flagsпараметра SetupInstallFromInfSection. Чтобы отправить уведомление об отмене регистрации, включите SPINST_REGISTERCALLBACKAWARE плюс SPINST_UNREGSVR в параметр Flags .

Подпрограмма обратного вызова, заданная параметром MsgHandlerпараметра SetupInstallFromInfSection , должна иметь тип PSP_FILE_CALLBACK. Задайте для параметра Context тот же контекст, который указан в setupInstallFromInfSection. Задайте для параметра Notificationзначение SPFILENOTIFY_STARTREGISTRATION.

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

Параметры

Параметр 1

Указатель на структуру SP_REGISTER_CONTROL_STATUS , содержащую сведения о зарегистрированном или незарегистрированном файле. Член cbsize должен иметь размер структуры. Для элемента FileName должен быть задан полный путь к регистрируемого файла. Win32Error не используется и должен иметь значение NO_ERROR. FailureCode не используется и должен иметь значение SPREG_SUCCESS.

Param2

Если файл регистрируется, параметру Param2 следует задать указатель на ненулевое значение. Если файл отменяется, параметру Param2 следует задать нулевой указатель.

Возвращаемое значение

После получения уведомления функция обратного вызова может вернуть одно из следующих значений.

Код возврата Описание
FILEOP_ABORT
 Не регистрируйте или отменяйте регистрацию файла и прекращайте обработку раздела INF.
FILEOP_DOIT
 Зарегистрируйте или отмените регистрацию файла и продолжайте обработку раздела INF.
FILE_SKIP
 Пропустите регистрацию или отмену регистрации файла, но продолжайте обработку раздела INF

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Setupapi.h

См. также раздел

Обзор

Уведомления

SetupInstallFromInfSection

SPFILENOTIFY_ENDREGISTRATION