Partager via


WdsCliTransferImage, fonction (wdsclientapi.h)

Transfère une image d’un serveur WDS vers le client WDS.

Syntaxe

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

Paramètres

[in] hImage

Un handle d’image WDS qui fait référence à une image distante.

[in] pwszLocalPath

Pointeur vers une valeur de chaîne terminée par null qui contient le chemin d’accès complet à l’emplacement local pour stocker le fichier image en cours de transfert.

[in] dwFlags

Options associées au transfert de fichiers.

Valeur Signification
WDS_CLI_TRANSFER_ASYNCHRONOUS
Cet indicateur spécifie un transfert asynchrone.

[in] dwReserved

Ce paramètre est réservé.

[in, optional] pfnWdsCliCallback

Pointeur vers une fonction de rappel facultative qui recevra des rappels pour ce transfert.

[in, optional] pvUserData

Pointeur vers des informations utilisateur facultatives qui peuvent être passées à la fonction de rappel.

[out] phTransfer

Pointeur vers un handle de transfert qui peut être utilisé avec les fonctions WdsCliWaitForTransfer ou WdsCliCancelTransfer pour attendre que le transfert se termine ou pour annuler le transfert.

Valeur retournée

Si la fonction réussit, le retour est S_OK.

Remarques

Appelez la fonction WdsCliClose pour fermer le handle retourné par cette fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wdsclientapi.h
Bibliothèque WdsClientAPI.lib
DLL WdsClientAPI.dll