使用 Windows 部署服务客户端 API
在标准 Windows 部署服务 (WDS) 解决方案无法用于安装 Windows 的环境中，WDS 客户端的 API 使开发人员能够编写自定义部署应用程序。 应用程序可以使用此 API 与 WDS 服务器通信，以获取有关服务器提供的系统映像的信息。 自定义 WDS 客户端应用程序应遵循以下准则。
在服务器上安装 WDS 角色
- Windows 部署服务 (WDS) 是远程安装服务的修订版本 (RIS) ，需要服务器上的 WDS 服务器角色才能实现自定义 WDS 客户端解决方案。
- 从 Windows Server 2008 和 Windows Server 2003 开始，WDS 将 RIS 替换为 Service Pack 2 (SP2) 。
- 必须使用 Service Pack 1 (SP1) 将 Windows Server 2003 上的 RIS 服务器更新为 WDS。 可以使用 Windows 自动安装工具包 (WAIK) 安装 WDS 服务器角色。
启动 Windows PE 2.0
Windows PE 2.0 必须启动（如果尚未启动）。 仅当 WDS 客户端和支持 DLL 处于安装处理的 Microsoft Windows 预安装环境 (Windows PE 2.0) 阶段时，setup.exe才会加载它。
- 当新计算机连接到网络时，内置的预启动执行环境 (PXE) 技术可用于下载网络启动程序。 有关 PXE 启动计算机以安装 Windows 的详细信息，请参阅 Windows 部署服务更新分步指南。
- Windows PE 2.0 的 RAMDISK 可启动映像可以存储在 中。WIM 格式并作为网络启动过程的一部分下载。 然后，可以直接从该媒体加载和运行 Windows PE。
打开与 WDS 服务器的会话
WDS 客户端必须打开与 WDS 服务器的会话。
- 使用 WdsCliCreateSession 函数打开与 WDS 服务器的会话。 此函数采用服务器的名称或 IP 地址，并接收 WDS 客户端会话句柄的地址。
- 如果打开与服务器的会话需要对 WDS 客户端进行身份验证，则应用程序应在调用 WdsCliCreateSession 函数时提供包含客户端凭据的WDS_CLI_CRED结构的地址。 应用程序可以使用 WdsCliAuthorizeSession 函数将匿名会话转换为经过身份验证的会话。
- 不再需要使用 WdsCliCreateSession 函数打开的会话时，应用程序应使用 WdsCliClose 函数关闭会话持有的句柄和释放资源。
枚举 WDS 服务器上的系统映像
WDS 客户端可以使用 API 枚举 WDS 服务器上的系统映像。
- 使用 WdsCliFindFirstImage 函数获取第一个映像的句柄，并初始化 WDS 服务器上的图像枚举。
- 使用 WdsCliFindNextImage 函数递增由 WdsCliFindFirstImage 函数启动的枚举。 WdsCliFindNextImage 函数获取下一个图像的句柄。
- 使用 WdsCliGetImageIndex 函数获取当前图像的图像索引。 此值仅在再次使用 WdsCliFindNextImage 或 WdsCliClose 函数之前有效。
- 使用 WdsCliGetEnumerationFlags 函数获取有关图像筛选的信息标志。
获取有关图像的信息
WDS 客户端可以使用 API 获取有关 WDS 服务器上的映像的信息。 以下函数获取有关当前图像的信息。 由于 WdsCliFindFirstImage 和 WdsCliFindNextImage 函数更改当前图像句柄值，因此，在再次调用 WdsCliFindFirstImage 或 WdsCliFindNextImage 函数之前，应用程序应存储它获取和将来需要的任何信息。
- 使用 WdsCliGetImageArchitecture 函数获取当前映像的处理器体系结构。
- 使用 WdsCliGetImagePath 函数获取包含当前图像的图像文件的相对路径。
- 使用 WdsCliGetImageSize 函数获取图像大小。
- 使用 WdsCliGetImageVersion 函数获取映像版本。
- 使用 WdsCliGetImageLanguage 函数获取当前图像的默认语言。
- 使用 WdsCliGetImageLanguages 函数获取当前图像支持的语言数组。
- 使用 WdsCliGetImageLastModifiedTime 返回当前图像的上次修改时间。
- 使用 WdsCliGetImageName 函数获取当前映像的名称。
- 使用 WdsCliGetImageDescription 函数获取当前图像的说明。
- 使用 WdsCliGetImageGroup 函数获取当前映像的映像组名称。
- 使用 WdsCliGetImageHalName 函数获取当前映像的硬件抽象层 (HAL) 名称。
记录 WDS 客户端事件
WDS 客户端库的日志记录功能使安装进度事件能够从客户端发送到 WDS 服务器。
- 使用 WdsCliInitializeLog 函数初始化 WDS 客户端会话的日志。
- 使用 WdsCliLog 函数将事件消息写入 WDS 服务器日志。
- 在 Windows Server 2008 上，WDS 服务器将客户端事件写入可通过eventvwr.exe和调试跟踪日志查看的应用程序特定事件日志。 在启用了调试日志记录的 Windows Server 2003 上，WDS 服务器会将客户端事件写入位于 %windir%\tracing\wdsserver.log 的日志文件中。 必须在服务器上启用 WDS 客户端日志记录才能捕获这些事件。
相关主题