PFN_WdsCliCallback fonction de rappel (wdsclientapi.h)

Article
03/03/2024

Définit une fonction de rappel que WDS peut appeler pour la notification de progression et les messages d’erreur lors d’un transfert de fichier ou d’image.

Syntaxe

PFN_WdsCliCallback PfnWdsclicallback;

void PfnWdsclicallback(
  [in]           DWORD dwMessageId,
  [in, optional] WPARAM wParam,
  [in, optional] LPARAM lParam,
  [in, optional] PVOID pvUserData
)
{...}

Paramètres

[in] dwMessageId

Type de message et signification du paramètre lParam .

Ce paramètre ne peut avoir qu’une des valeurs suivantes.

Valeur	Signification
WDS_CLI_MSG_START 0	Message de début de transfert. Le paramètre lParam est un pointeur vers une valeur LARGE_INTEGER contenant la taille de fichier du transfert.
WDS_CLI_MSG_COMPLETE 1	Message de transfert terminé. Le paramètre lParam est une valeur HRESULT .
WDS_CLI_MSG_PROGRESS 2	Message de progression du transfert. Le paramètre lParam est une valeur ULONG qui correspond au pourcentage de transfert terminé.
WDS_CLI_MSG_TEXT 3	Message d’information. Le paramètre lParam est un pointeur vers une chaîne de débogage qui peut être utilisée à des fins de diagnostic.

[in, optional] wParam

Ce paramètre de message doit toujours être défini sur la valeur du handle de transfert retourné par la fonction WdsCliTransferImage ou WdsCliTransferFile .

[in, optional] lParam

La signification de la valeur contenue dans ce paramètre dépend du paramètre dwMessageId .

[in, optional] pvUserData

Pointeur vers des informations utilisateur facultatives jointes à cette session par la fonction WdsCliTransferImage ou WdsCliTransferFile .

Valeur de retour

None

Remarques

Une fonction de rappel peut appeler la fonction WdsCliCancelTransfer pour annuler un transfert. Bien qu’une fonction de rappel puisse également appeler la fonction WdsCliWaitForTransfer , cela n’est pas recommandé, car aucun rappel supplémentaire ne sera reçu tant que le rappel actuel n’est pas débloqué.

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

Partager via