Share via

SPFILENOTIFY_STARTREGISTRATION消息

  • 项目

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

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

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

参数

Param1

指向 SP_REGISTER_CONTROL_STATUS 结构的指针，该结构包含有关正在注册或注销的文件的信息。 成员 cbsize 应设置为 结构的大小。 应将 FileName 成员设置为所注册文件的完全限定路径。 Win32Error 未使用，应设置为NO_ERROR。 不使用 FailureCode，应设置为 SPREG_SUCCESS。

Param2

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

返回值

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

返回代码 说明
FILEOP_ABORT
 请勿注册或注销文件，并停止处理 INF 部分。
FILEOP_DOIT
 注册或注销文件并继续处理 INF 部分。
FILE_SKIP
 跳过文件的注册或注销，但继续处理 INF 部分

要求

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

另请参阅

概述

通知

SetupInstallFromInfSection

SPFILENOTIFY_ENDREGISTRATION