Condividi tramite


Funzione WdsCliObtainDriverPackagesEx (wdsclientapi.h)

Questa funzione ottiene i pacchetti driver (file INF) applicabili al file XML di query del driver WDS specificato. La funzione WdsCliFreeStringArray può essere usata per liberare la matrice di valori stringa allocati da questa funzione. La funzione WdsCliGetDriverQueryXml può essere usata per generare la stringa XML di query del driver necessaria.

Sintassi

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

Parametri

[in] hSession

Handle a una sessione con il server WDS. Questo handle viene restituito dalla funzione WdsCliCreateSession .

[out] pwszMachineInfo

Puntatore a una stringa contenente XML di query del driver WDS che può essere generato chiamando la funzione WdsCliGetDriverQueryXml .

[out] ppwszServerName

Puntatore a un puntatore a un valore stringa che riceve l'indirizzo IP del server che ospita i pacchetti driver.

[out] pppwszDriverPackages

Matrice di valori stringa che rappresentano i percorsi completi per i pacchetti driver (file INF). L'indirizzo IP (Internet Protocol) anziché un nome computer viene restituito come parte del percorso. Ad esempio, un valore stringa \172.31.224.245\REMINST\Stores\Drivers\driver.inf nella matrice fornisce il percorso completo a driver.inf.

[out] pulCount

Numero di pacchetti driver restituiti da pppwszDriverPackages.

Valore restituito

Se la funzione ha esito positivo, la restituzione è S_OK.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wdsclientapi.h
Libreria WdsClientAPI.lib
DLL WdsClientAPI.dll