SetupSetDirectoryIdW 函数 (setupapi.h)

[此函数可用于“要求”部分所示的操作系统。 在后续版本中可能会更改或不可用。 不应再使用 SetupAPI 来安装应用程序。 请改用 Windows Installer 来开发应用程序安装程序。 SetupAPI 继续用于安装设备驱动程序。]

SetupSetDirectoryId 函数将 INF 文件中的目录标识符与特定目录相关联。

语法

WINSETUPAPI BOOL SetupSetDirectoryIdW(
  [in] HINF   InfHandle,
  [in] DWORD  Id,
  [in] PCWSTR Directory
);

参数

[in] InfHandle

加载的 INF 文件的句柄。

[in] Id

用于关联的目录标识符(DIRID)。 此参数可以 NULL。 此 DIRID 必须大于或等于DIRID_USER。 如果此 DIRID 已存在关联,则会覆盖该关联。 如果 IDNULL,则忽略 Directory 参数,并删除当前用户定义的 DIRID 集。

[in] Directory

指向 null终止字符串的指针,该字符串指定要与 Id关联的目录路径。此参数可以 NULL。 如果 目录NULL,则与 ID 关联的任何目录均未关联。 如果 ID 当前未与目录关联,则不会生成任何错误。

返回值

如果函数成功,则返回值为非零值。

如果函数失败,则返回值为 0(零)。 若要获取扩展的错误信息,请调用 GetLastError

言论

SetupSetDirectoryId 可用于排队文件复制操作,以指定仅在运行时已知的目标位置。

设置目录标识符后,此函数将遍历所有追加的 INF 文件,如果其中任一文件具有未解析的字符串替换,该函数将尝试根据新的 DIRID 映射重新应用字符串替换。 因此,调用 SetupSetDirectoryId后,某些 INF 值可能会更改。

DIRID_ABSOLUTE_16BIT不是 ID的有效值,这可确保与 16 位设置兼容。

注意

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

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 setupapi.h
Setupapi.lib
DLL Setupapi.dll

另请参阅

Functions

概述