SP_REGISTER_CONTROL_STATUSA结构（setupapi.h）

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

言论

注意

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