WdsCliObtainDriverPackagesEx 函数 (wdsclientapi.h)

此函数获取适用于指定 WDS 驱动程序查询 XML (INF 文件的驱动程序包) 。 WdsCliFreeStringArray 函数可用于释放此函数分配的字符串值数组。 WdsCliGetDriverQueryXml 函数可用于生成所需的驱动程序查询 XML 字符串。

语法

HRESULT WDSCLIAPI WdsCliObtainDriverPackagesEx(
  [in]  HANDLE hSession,
  [out] PWSTR  pwszMachineInfo,
  [out] PWSTR  *ppwszServerName,
  [out] PWSTR  **pppwszDriverPackages,
  [out] ULONG  *pulCount
);

参数

[in] hSession

与 WDS 服务器的会话的句柄。 此句柄由 WdsCliCreateSession 函数返回。

[out] pwszMachineInfo

指向包含可通过调用 WdsCliGetDriverQueryXml 函数生成的 WDS 驱动程序查询 XML 的字符串的指针。

[out] ppwszServerName

指向接收托管驱动程序包的服务器 IP 地址的字符串值的指针的指针。

[out] pppwszDriverPackages

字符串值的数组是驱动程序包 (INF 文件的完整路径。) Internet 协议 (IP) 地址，而不是计算机名称作为路径的一部分返回。 例如，数组中的字符串值 \172.31.224.245\REMINST\Stores\Drivers\driver.inf 提供 driver.inf 的完整路径。

[out] pulCount

pppwszDriverPackages 返回的驱动程序包数。

返回值

如果函数成功，则 返回S_OK。

要求

最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
目标平台	Windows
标头	wdsclientapi.h
Library	WdsClientAPI.lib
DLL	WdsClientAPI.dll