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

структура SP_REGISTER_CONTROL_STATUSW (setupapi.h)

  • Статья

Структура SP_REGISTER_CONTROL_STATUS содержит сведения о зарегистрированном или отмене регистрации файла с помощью директивы INF RegisterDlls для самостоятельной регистрации библиотек DLL в Windows 2000.

Когда SetupInstallFromInfSection отправляет SPFILENOTIFY_STARTREGISTRATION или SPFILENOTIFY_ENDREGISTRATION уведомление в подпрограмму обратного вызова, вызывающий объект должен предоставить указатель на структуру SP_REGISTER_CONTROL_STATUS в параметре MsgHandler .

Синтаксис

typedef struct _SP_REGISTER_CONTROL_STATUSW {
  DWORD  cbSize;
  PCWSTR FileName;
  DWORD  Win32Error;
  DWORD  FailureCode;
} SP_REGISTER_CONTROL_STATUSW, *PSP_REGISTER_CONTROL_STATUSW;

Члены

cbSize

FileName

Полный путь к зарегистрированным или отмененным файлам.

Win32Error

Для уведомления SPFILENOTIFY_STARTREGISTRATION этот элемент не используется и должен иметь значение NO_ERROR. Для уведомления SPFILENOTIFY_ENDREGISTRATION задайте для параметра системный код ошибки.

FailureCode

Для уведомления SPFILENOTIFY_STARTREGISTRATION этот элемент не используется и должен иметь значение SPREG_SUCCESS. Для уведомления SPFILENOTIFY_ENDREGISTRATION задайте один из следующих кодов сбоев, указывающих результат регистрации.

Значение Значение
SPREG_SUCCESS
 Файл был успешно зарегистрирован или отменен. WinError не используется.
SPREG_LOADLIBRARY
 Сбой LoadLibrary для файла. WinError содержит расширенный код ошибки из компонента.
SPREG_GETPROCADDR
 Сбой GetProcAddress для файла. WinError содержит расширенный код ошибки из компонента.
SPREG_REGSVR
 Сбой точки входа DLLRegisterServer. WinError содержит расширенный код ошибки из компонента.
SPREG_DLLINSTALL
 Сбой точки входа DLLУстановки. WinError содержит расширенный код ошибки из компонента.
SPREG_TIMEOUT
 Регистрация или отмена регистрации файла превысили указанное время ожидания. WinError имеет значение ERROR_TIMEOUT.
SPREG_UNKNOWN
 Регистрация или отмена регистрации файла завершилась сбоем по неизвестной причине. WinError указывает расширенный код ошибки из компонента.

Комментарии

Примечание

Заголовок setupapi.h определяет SP_REGISTER_CONTROL_STATUS в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

Обзор

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

Структуры