WdsCliObtainDriverPackages function (wdsclientapi.h)

This function obtains from a WDS image, the driver packages (INF files) that can be used on this computer. The WdsCliFreeStringArray function can be used to free the array of string values allocated by this function.

Syntax

HRESULT WDSCLIAPI WdsCliObtainDriverPackages(
  [in]  HANDLE hImage,
  [out] PWSTR  *ppwszServerName,
  [out] PWSTR  **pppwszDriverPackages,
  [out] ULONG  *pulCount
);

Parameters

[in] hImage

A handle to a WDS image.

[out] ppwszServerName

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

[out] pppwszDriverPackages

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 \172.31.224.245\REMINST\Stores\Drivers\driver.inf in the array gives the full path to driver.inf.

[out] pulCount

The number of driver packages returned by pppwszDriverPackages.

Return value

If the function succeeds, the return is S_OK.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header wdsclientapi.h
Library WdsClientAPI.lib
DLL WdsClientAPI.dll

See also

Windows Deployment Services Client Functions