Partager via


WdsCliObtainDriverPackagesEx, fonction (wdsclientapi.h)

Cette fonction obtient les packages de pilotes (fichiers INF) applicables au xml de requête de pilote WDS spécifié. La fonction WdsCliFreeStringArray peut être utilisée pour libérer le tableau des valeurs de chaîne allouées par cette fonction. La fonction WdsCliGetDriverQueryXml peut être utilisée pour générer la chaîne XML de requête de pilote requise.

Syntaxe

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

Paramètres

[in] hSession

Handle pour une session avec le serveur WDS. Ce handle est retourné par la fonction WdsCliCreateSession .

[out] pwszMachineInfo

Pointeur vers une chaîne contenant le code XML de requête du pilote WDS qui peut être généré en appelant la fonction WdsCliGetDriverQueryXml .

[out] ppwszServerName

Pointeur vers un pointeur vers une valeur de chaîne qui reçoit l’adresse IP du serveur hébergeant les packages de pilotes.

[out] pppwszDriverPackages

Tableau de valeurs de chaîne qui sont les chemins d’accès complets pour les packages de pilotes (fichiers INF).) L’adresse IP (Internet Protocol), plutôt qu’un nom d’ordinateur, est retournée dans le chemin d’accès. Par exemple, une valeur de chaîne \172.31.224.245\REMINST\Stores\Drivers\driver.inf dans le tableau donne le chemin d’accès complet à driver.inf.

[out] pulCount

Nombre de packages de pilotes retournés par pppwszDriverPackages.

Valeur retournée

Si la fonction réussit, le retour est S_OK.

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wdsclientapi.h
Bibliothèque WdsClientAPI.lib
DLL WdsClientAPI.dll