SP_REGISTER_CONTROL_STATUSW 结构 (setupapi.h)

项目
03/04/2024

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

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

语法

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