Edit

WdsCliTransferFile function (wdsclientapi.h)

  • Article

Transfers a file from a WDS server to the WDS client using a multicast transfer protocol.

Syntax

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

Parameters

[in] pwszServer

A pointer to a null-terminated string value that contains the WDS server name.

[in] pwszNamespace

A pointer to a null-terminated string value that contains the multicast namespace name for the image.

[in] pwszRemoteFilePath

A pointer to a null-terminated string value that contains the full path for the remote location from which to copy the file being transferred.

[in] pwszLocalFilePath

A pointer to a null-terminated string value that contains the full path to the local location to store the file being transferred.

[in] dwFlags

Options associated with the file transfer.

Value Meaning
WDS_CLI_TRANSFER_ASYNCHRONOUS
 This flag specifies an asynchronous transfer.

[in] dwReserved

This parameter is reserved.

[in, optional] pfnWdsCliCallback

A pointer to an optional callback function for this transfer.

[in, optional] pvUserData

A pointer to optional user information that can be passed to the callback function.

[out] phTransfer

A pointer to a transfer handle that can be used with the WdsCliWaitForTransfer or WdsCliCancelTransfer functions to wait for the transfer to complete or to cancel the transfer.

Return value

If the function succeeds, the return is S_OK.

Remarks

Call the WdsCliClose function to close the handle returned by this function.

Requirements

Requirement Value
Minimum supported client Windows Vista with SP1 [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wdsclientapi.h
Library WdsClientAPI.lib
DLL WdsClientAPI.dll