Compartir a través de

Función WdsCliObtainDriverPackagesEx (wdsclientapi.h)

  • Artículo

Esta función obtiene los paquetes de controladores (archivos INF) que son aplicables al XML de consulta del controlador WDS especificado. La función WdsCliFreeStringArray se puede usar para liberar la matriz de valores de cadena asignados por esta función. La función WdsCliGetDriverQueryXml se puede usar para generar la cadena XML de consulta del controlador necesaria.

Sintaxis

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

Parámetros

[in] hSession

Identificador de una sesión con el servidor WDS. La función WdsCliCreateSession devuelve este identificador.

[out] pwszMachineInfo

Puntero a una cadena que contiene el XML de consulta del controlador WDS que se puede generar mediante una llamada a la función WdsCliGetDriverQueryXml .

[out] ppwszServerName

Puntero a un puntero a un valor de cadena que recibe la dirección IP del servidor que hospeda los paquetes de controladores.

[out] pppwszDriverPackages

Matriz de valores de cadena que son las rutas de acceso completas para los paquetes de controladores (archivos INF). La dirección del Protocolo de Internet (IP), en lugar de un nombre de equipo, se devuelve como parte de la ruta de acceso. Por ejemplo, un valor de cadena \172.31.224.245\REMINST\Stores\Drivers\driver.inf en la matriz proporciona la ruta de acceso completa a driver.inf.

[out] pulCount

Número de paquetes de controladores devueltos por pppwszDriverPackages.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es S_OK.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wdsclientapi.h
Library WdsClientAPI.lib
Archivo DLL WdsClientAPI.dll