Compartilhar via

Função WdsCliTransferFile (wdsclientapi.h)

  • Artigo

Transfere um arquivo de um servidor WDS para o cliente WDS usando um protocolo de transferência multicast.

Sintaxe

HRESULT WDSCLIAPI WdsCliTransferFile(
  [in]           PCWSTR             pwszServer,
  [in]           PCWSTR             pwszNamespace,
  [in]           PCWSTR             pwszRemoteFilePath,
  [in]           PCWSTR             pwszLocalFilePath,
  [in]           DWORD              dwFlags,
  [in]           DWORD              dwReserved,
  [in, optional] PFN_WdsCliCallback pfnWdsCliCallback,
  [in, optional] PVOID              pvUserData,
  [out]          PHANDLE            phTransfer
);

Parâmetros

[in] pwszServer

Um ponteiro para um valor de cadeia de caracteres terminada em nulo que contém o nome do servidor WDS.

[in] pwszNamespace

Um ponteiro para um valor de cadeia de caracteres terminada em nulo que contém o nome do namespace multicast para a imagem.

[in] pwszRemoteFilePath

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

[in] pwszLocalFilePath

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 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 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