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 関数を呼び出して、この関数によって返されるハンドルを閉じます。

要件

要件	値
サポートされている最小のクライアント	WINDOWS Vista と SP1 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wdsclientapi.h
Library	WdsClientAPI.lib
[DLL]	WdsClientAPI.dll