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 と SP1 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wdsclientapi.h
Library	WdsClientAPI.lib
[DLL]	WdsClientAPI.dll