Skip to main content
WdsCliObtainDriverPackagesEx function

This function obtains the driver packages (INF files) that are applicable to the specified WDS driver query XML. The WdsCliFreeStringArray function can be used to free the array of string values allocated by this function. The WdsCliGetDriverQueryXml function can be used to generate the required driver query XML string.


HRESULT WDSCLIAPI WdsCliObtainDriverPackagesEx(
  _In_  HANDLE hSession,
  _Out_ PWSTR  pwszDriverQuery,
  _Out_ PWSTR  *ppwszServerName,
  _Out_ PWSTR  **pppwszDriverPackages,
  _Out_ ULONG  *pulCount


hSession [in]

A handle to a session with the WDS server. This handle is returned by the WdsCliCreateSession function.

pwszDriverQuery [out]

A pointer to a string containing WDS driver query XML which can be generated by calling the WdsCliGetDriverQueryXml function.

ppwszServerName [out]

A pointer to a pointer to a string value that receives the IP address of the server hosting the driver packages.

pppwszDriverPackages [out]

An array of string values that are the full paths for the driver packages (INF files.) The Internet Protocol (IP) address, rather than a computer name, is returned as part of the path. For example, a string value \\\REMINST\Stores\Drivers\driver.inf in the array gives the full path to driver.inf.

pulCount [out]

The number of driver packages returned by pppwszDriverPackages.

Return value

If the function succeeds, the return is S_OK.


Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]