SP_REGISTER_CONTROL_STATUSA结构 (setupapi.h)

项目
08/26/2023

SP_REGISTER_CONTROL_STATUS 结构包含有关使用 RegisterDlls INF 指令在 Windows 2000 上自行注册 DLL 的文件的信息。

当 SetupInstallFromInfSection 向回调例程发送SPFILENOTIFY_STARTREGISTRATION或SPFILENOTIFY_ENDREGISTRATION通知时，调用方必须提供指向 MsgHandler 参数中SP_REGISTER_CONTROL_STATUS结构的指针。

语法

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	DLL安装入口点返回失败。 WinError 包含组件中的扩展错误代码。
SPREG_TIMEOUT	文件注册或注销超出了指定的超时时间。 WinError 设置为 ERROR_TIMEOUT。
SPREG_UNKNOWN	由于未知原因，文件注册或注销失败。 WinError 指示组件的扩展错误代码。

注解

注意

setupapi.h 标头将SP_REGISTER_CONTROL_STATUS定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。