Fonction WdsCliTransferFile (wdsclientapi.h)

Article
03/06/2024

Transfère un fichier d’un serveur WDS vers le client WDS à l’aide d’un protocole de transfert multidiffusion.

Syntaxe

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

Paramètres

[in] pwszServer

Pointeur vers une valeur de chaîne terminée par null qui contient le nom du serveur WDS.

[in] pwszNamespace

Pointeur vers une valeur de chaîne terminée par null qui contient le nom de l’espace de noms multidiffusion pour l’image.

[in] pwszRemoteFilePath

Pointeur vers une valeur de chaîne terminée par null qui contient le chemin d’accès complet de l’emplacement distant à partir duquel copier le fichier en cours de transfert.

[in] pwszLocalFilePath

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

Partager via