Função WdsCliObtainDriverPackagesEx (wdsclientapi.h)

Essa função obtém os pacotes de driver (arquivos INF) aplicáveis ao XML de consulta de driver do WDS especificado. A função WdsCliFreeStringArray pode ser usada para liberar a matriz de valores de cadeia de caracteres alocados por essa função. A função WdsCliGetDriverQueryXml pode ser usada para gerar a cadeia de caracteres XML de consulta de driver necessária.

Sintaxe

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

Parâmetros

[in] hSession

Um identificador para uma sessão com o servidor WDS. Esse identificador é retornado pela função WdsCliCreateSession .

[out] pwszMachineInfo

Um ponteiro para uma cadeia de caracteres que contém xML de consulta de driver do WDS que pode ser gerado chamando a função WdsCliGetDriverQueryXml .

[out] ppwszServerName

Um ponteiro para um ponteiro para um valor de cadeia de caracteres que recebe o endereço IP do servidor que hospeda os pacotes de driver.

[out] pppwszDriverPackages

Uma matriz de valores de cadeia de caracteres que são os caminhos completos para os pacotes de driver (arquivos INF.) O endereço IP (protocolo IP), em vez de um nome de computador, é retornado como parte do caminho. Por exemplo, um valor de cadeia de caracteres \172.31.224.245\REMINST\Stores\Drivers\driver.inf na matriz fornece o caminho completo para driver.inf.

[out] pulCount

O número de pacotes de driver retornados por pppwszDriverPackages.

Valor retornado

Se a função for bem-sucedida, o retorno será S_OK.

Requisitos

Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wdsclientapi.h
Biblioteca	WdsClientAPI.lib
DLL	WdsClientAPI.dll