SetupPromptForDiskA 函数 （setupapi.h）
[此函数可用于“要求”部分所示的操作系统。 在后续版本中可能会更改或不可用。 不应再使用 SetupAPI 来安装应用程序。 请改用 Windows Installer 来开发应用程序安装程序。 SetupAPI 继续用于安装设备驱动程序。]
SetupPromptForDisk 函数显示一个对话框，提示用户输入磁盘。
语法
WINSETUPAPI UINT SetupPromptForDiskA(
[in] HWND hwndParent,
[in] PCSTR DialogTitle,
[in] PCSTR DiskName,
[in] PCSTR PathToSource,
[in] PCSTR FileSought,
[in] PCSTR TagFile,
[in] DWORD DiskPromptStyle,
[in, out] PSTR PathBuffer,
[in] DWORD PathBufferSize,
[in, out] PDWORD PathRequiredSize
);
参数
[in] hwndParent
此对话框的父窗口的句柄。
[in] DialogTitle
指向指定对话框标题的 null终止字符串的可选指针。 如果此参数 NULL，则使用默认值“”%s--Files Needed“”（localized）。 “%s”替换为从父窗口检索的文本。 如果未从父窗口检索任何文本，标题为“需要文件”。
[in] DiskName
指向 null-terminated 字符串的可选指针，该字符串指定要插入的磁盘的名称。 如果此参数 NULL，则使用默认的“（未知）”（本地化）。
[in] PathToSource
指向 null-terminated 字符串的可选指针，用于指定文件的预期位置的路径部分，例如 F：\x86。 如果未指定，则使用 SetupPromptForDisk 最近找到文件的路径。 如果该列表为空，则使用系统默认值。
[in] FileSought
指向 null-terminated 字符串的指针，该字符串指定所需的文件名称（仅文件名部分）。 如果用户单击 “浏览”按钮，将显示文件名。 此例程使用其压缩的表单名称查找文件;因此，可以传递 cmd.exe，而不必担心文件实际上作为源媒体上的cmd.ex_存在。
[in] TagFile
指向 null终止字符串的可选指针，该字符串指定一个标记文件（仅文件名部分），用于标识特定可移动媒体卷的存在。 如果当前选择的路径将文件放置在可移动媒体上，并且指定了标记文件，SetupPromptForDisk 查找驱动器根目录中的标记文件以确定是否继续。
例如，如果 PathToSource 为 A：\x86，则 tagfile 为 disk1.tag，并且用户将 B：\x86 键入到提示对话框的编辑控件中，则例程将查找 B：\disk1.tag 以确定是否继续。 如果未找到标记文件，该函数将使用 PathToSource查找标记文件。
如果未指定标记文件，可移动媒体的工作方式就像不可移动媒体一样，FileSought 在继续之前查找。
[in] DiskPromptStyle
指定对话框的行为。 此参数可以是以下标志的组合。
IDF_CHECKFIRST
在显示提示对话框之前检查文件/磁盘，如果存在，请立即返回DPROMPT_SUCCESS。
IDF_NOBEEP
阻止对话框在首次出现时发出蜂鸣声来引起用户的注意。
IDF_NOBROWSE
不显示浏览选项。
IDF_NOCOMPRESSED
不检查源文件的压缩版本。
IDF_NODETAILS
不显示详细信息。
IDF_NOFOREGROUND
阻止对话框成为前台窗口。
IDF_NOSKIP
不显示跳过选项。
IDF_OEMDISK
提示硬件制造商提供的磁盘。
IDF_WARNIFSKIP
警告用户跳过文件可能会影响安装。
[in, out] PathBuffer
指向缓冲区的可选指针，在返回时，通过对话框接收用户指定位置的路径（无文件名）。 应使用 null-terminated 字符串。 null-terminated 字符串不应超过目标缓冲区的大小。 可以调用函数一次以获取所需的缓冲区大小、分配必要的内存，然后再次调用该函数以检索数据。 使用此技术，可以避免由于缓冲区大小不足而导致的错误。 请参阅“备注”部分。
[in] PathBufferSize
PathBuffer指向的缓冲区的大小（以字符为单位）。 它应该至少MAX_PATH长。 这包括 null 终止符。
[in, out] PathRequiredSize
可选指针，该变量接收 PathBuffer所需的大小（以字符为单位）。 这包括 null 终止符。
返回值
该函数返回以下值之一。
若要获取扩展的错误信息，请调用 GetLastError。
言论
如果使用 PathBufferNULL 和 PathBufferSize 为零调用此函数，则该函数会将指定数据保存在 PathRequiredSize指向的变量中所需的缓冲区大小。 如果函数成功，则返回值NO_ERROR。 否则，返回值是“返回值”部分所述的值之一。
注意
setupapi.h 标头将 SetupPromptForDisk 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | 窗户 |
| 标头 | setupapi.h |
| 库 | Setupapi.lib |
| DLL | Setupapi.dll |