Поделиться через


Функция WdsCliTransferImage (wdsclientapi.h)

Передает образ с сервера WDS клиенту WDS.

Синтаксис

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

Параметры

[in] hImage

Дескриптор образа WDS, ссылающийся на удаленный образ.

[in] pwszLocalPath

Указатель на строковое значение, завершающееся null, которое содержит полный путь к локальному расположению для хранения передаваемого файла изображения.

[in] dwFlags

Параметры, связанные с передачей файлов.

Значение Значение
WDS_CLI_TRANSFER_ASYNCHRONOUS
Этот флаг указывает асинхронную передачу.

[in] dwReserved

Этот параметр зарезервирован.

[in, optional] pfnWdsCliCallback

Указатель на необязательную функцию обратного вызова, которая будет принимать обратные вызовы для этой передачи.

[in, optional] pvUserData

Указатель на необязательные сведения о пользователе, которые можно передать в функцию обратного вызова.

[out] phTransfer

Указатель на дескриптор передачи, который можно использовать с функциями WdsCliWaitForTransfer или WdsCliCancelTransfer для ожидания завершения передачи или отмены передачи.

Возвращаемое значение

Если функция выполняется успешно, возвращается S_OK.

Комментарии

Вызовите функцию WdsCliClose , чтобы закрыть дескриптор, возвращенный этой функцией.

Требования

Требование Значение
Минимальная версия клиента Windows Vista с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header wdsclientapi.h
Библиотека WdsClientAPI.lib
DLL WdsClientAPI.dll