Compartilhar via

Função WdsCliTransferImage (wdsclientapi.h)

  • Artigo

Transfere uma imagem de um servidor WDS para o cliente WDS.

Sintaxe

HRESULT WDSCLIAPI WdsCliTransferImage(
  [in]           HANDLE             hImage,
  [in]           PWSTR              pwszLocalPath,
  [in]           DWORD              dwFlags,
  [in]           DWORD              dwReserved,
  [in, optional] PFN_WdsCliCallback pfnWdsCliCallback,
  [in, optional] PVOID              pvUserData,
  [out]          PHANDLE            phTransfer
);

Parâmetros

[in] hImage

Um identificador de imagem do WDS que se refere a uma imagem remota.

[in] pwszLocalPath

Um ponteiro para um valor de cadeia de caracteres terminada em nulo que contém o caminho completo para o local para armazenar o arquivo de imagem que está sendo transferido.

[in] dwFlags

Opções associadas à transferência de arquivo.

Valor Significado
WDS_CLI_TRANSFER_ASYNCHRONOUS
 Esse sinalizador especifica uma transferência assíncrona.

[in] dwReserved

Esse parâmetro é reservado.

[in, optional] pfnWdsCliCallback

Um ponteiro para uma função de retorno de chamada opcional que receberá retornos de chamada para essa transferência.

[in, optional] pvUserData

Um ponteiro para informações opcionais do usuário que podem ser passadas para a função de retorno de chamada.

[out] phTransfer

Um ponteiro para um identificador de transferência que pode ser usado com as funções WdsCliWaitForTransfer ou WdsCliCancelTransfer para aguardar a conclusão da transferência ou cancelar a transferência.

Retornar valor

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

Comentários

Chame a função WdsCliClose para fechar o identificador retornado por essa função.

Requisitos

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