WdsCliObtainDriverPackagesEx-Funktion (wdsclientapi.h)

Diese Funktion ruft die Treiberpakete (INF-Dateien) ab, die für die angegebene XML-Abfrage des WDS-Treibers gelten. Die WdsCliFreeStringArray-Funktion kann verwendet werden, um das Array von Zeichenfolgenwerten frei zu geben, die von dieser Funktion zugeordnet werden. Die WdsCliGetDriverQueryXml-Funktion kann verwendet werden, um die erforderliche XML-Zeichenfolge für die Treiberabfrage zu generieren.

Syntax

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

Parameter

[in] hSession

Ein Handle für eine Sitzung mit dem WDS-Server. Dieses Handle wird von der WdsCliCreateSession-Funktion zurückgegeben.

[out] pwszMachineInfo

Ein Zeiger auf eine Zeichenfolge, die eine XML-Abfrage des WDS-Treibers enthält, die durch Aufrufen der WdsCliGetDriverQueryXml-Funktion generiert werden kann.

[out] ppwszServerName

Ein Zeiger auf einen Zeiger auf einen Zeichenfolgenwert, der die IP-Adresse des Servers empfängt, auf dem die Treiberpakete gehostet werden.

[out] pppwszDriverPackages

Ein Array von Zeichenfolgenwerten, die die vollständigen Pfade für die Treiberpakete (INF-Dateien) sind. Die IP-Adresse (Internet Protocol) wird anstelle eines Computernamens als Teil des Pfads zurückgegeben. Beispielsweise gibt ein Zeichenfolgenwert \172.31.224.245\REMINST\Stores\Drivers\driver.inf im Array den vollständigen Pfad zu driver.inf an.

[out] pulCount

Die Anzahl der von pppwszDriverPackages zurückgegebenen Treiberpakete.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird die Rückgabe S_OK.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wdsclientapi.h
Bibliothek	WdsClientAPI.lib
DLL	WdsClientAPI.dll