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

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

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

Синтаксис

typedef struct _SP_REGISTER_CONTROL_STATUSA {
  DWORD cbSize;
  PCSTR FileName;
  DWORD Win32Error;
  DWORD FailureCode;
} SP_REGISTER_CONTROL_STATUSA, *PSP_REGISTER_CONTROL_STATUSA;

Члены

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	DLLInstall точке входа вернулся сбой. 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

структуры