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

字串的指標，其中包含 WDS 驅動程式查詢 XML，可藉由呼叫 WdsCliGetDriverQueryXml 函式來產生。

[out] ppwszServerName

字串值的指標，可接收裝載驅動程式套件之伺服器的 IP 位址。

[out] pppwszDriverPackages

字串值的陣列，這些字串值是驅動程式套件的完整路徑， (INF files.) 網際網路通訊協定 (IP) 位址，而不是電腦名稱稱，會以路徑的一部分傳回。 例如，陣列中的字串值 \172.31.224.245\REMINST\Stores\Drivers\driver.inf 會提供 driver.inf 的完整路徑。

[out] pulCount

pppwszDriverPackages 傳回的驅動程式套件數目。

傳回值

如果函式成功，則傳回會 S_OK。

規格需求