通过

SPFILENOTIFY_ENDREGISTRATION消息

  • 项目

使用 RegisterDlls INF 指令自注册 DLL 时， SetupInstallFromInfSection 的调用方可能会在注册或取消注册每个文件时收到通知。 若要在注册或注销文件后向回调例程发送一次SPFILENOTIFY_ENDREGISTRATION通知，请在 SetupInstallFromInfSection 的 Flags 参数中包含 SPINST_REGISTERCALLBACKAWARE 加SPINST_REGSVR。 若要发送取消注册通知，请在 Flags 参数中包含SPINST_REGISTERCALLBACKAWARE加上SPINST_UNREGSVR。

由 SetupInstallFromInfSection 的 MsgHandler 参数指定的回调例程必须是PSP_FILE_CALLBACK类型。 将 Context 参数设置为 SetupInstallFromInfSection 中指定的同一上下文。 将 Notification 参数设置为 SPFILENOTIFY_ENDREGISTRATION。

SPFILENOTIFY_ENDREGISTRATION
  Param1 = (UINT_PTR) pointer to file information;
  Param2 = (UINT_PTR) file registration or unregistration;

参数

Param1

指向 SP_REGISTER_CONTROL_STATUS 结构的指针，其中包含有关正在注册或取消注册的文件的信息。 成员 cbsize 应设置为结构的大小。 应将 FileName 设置为要注册的文件的完全限定路径。 Win32Error 应设置为指示扩展错误代码 的系统 错误代码。 FailureCode 应设置为指示注册结果的有效失败代码之一。 有关有效的失败代码 ，请参阅SP_REGISTER_CONTROL_STATUS。

Param2

如果正在注册文件，则应将 Param2 设置为指向非零值的指针。 如果正在取消注册文件，则 Param2 应设置为指向零的指针。

返回值

收到通知后，回调函数可能会返回以下值之一。

返回代码 说明
FILEOP_ABORT
 停止处理 INF 部分。
FILEOP_DOIT
 继续处理 INF 部分。
FILE_SKIP
 继续处理 INF 部分

要求

要求 值
最低受支持的客户端
 Windows XP [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
标头
Setupapi.h

另请参阅

概述

通知

SetupInstallFromInfSection

SPFILENOTIFY_STARTREGISTRATION