WdsCliTransferFile 函式 (wdsclientapi.h)

使用多播傳輸通訊協定，將檔案從WDS伺服器傳輸至WDS用戶端。

語法

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

參數

[in] pwszServer

包含 WDS 伺服器名稱之 Null 終止字串值的指標。

[in] pwszNamespace

Null 終止字串值的指標，其中包含映像的多播命名空間名稱。

[in] pwszRemoteFilePath

Null 終止字串值的指標，其中包含要從中複製要傳送之檔案之遠端位置的完整路徑。

[in] pwszLocalFilePath

Null 終止字串值的指標，其中包含要儲存所傳輸檔案之本機位置的完整路徑。

[in] dwFlags

與文件傳輸相關聯的選項。

值	意義
WDS_CLI_TRANSFER_ASYNCHRONOUS	此旗標會指定異步傳輸。

[in] dwReserved

此參數已保留備用。

[in, optional] pfnWdsCliCallback

此傳輸之選擇性回呼函式的指標。

[in, optional] pvUserData

可傳遞至回呼函式之選擇性用戶資訊的指標。

[out] phTransfer

可搭配 WdsCliWaitForTransfer 或 WdsCliCancelTransfer 函式使用的傳輸句柄指標，以等候傳輸完成或取消傳輸。

傳回值

如果函式成功，則傳回會 S_OK。

備註

呼叫 WdsCliClose 函式以關閉此函式傳回的句柄。

規格需求

需求	值
最低支援的用戶端	具有SP1的 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	wdsclientapi.h
程式庫	WdsClientAPI.lib
Dll	WdsClientAPI.dll