PFN_WdsCliCallback funzione di callback (wdsclientapi.h)

Articolo
03/09/2024

Definisce una funzione di callback che WDS può chiamare per la notifica dello stato di avanzamento e i messaggi di errore durante il trasferimento di un file o di un'immagine.

Sintassi

PFN_WdsCliCallback PfnWdsclicallback;

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

Parametri

[in] dwMessageId

Tipo di messaggio e significato del parametro lParam .

Questo parametro può avere solo uno dei valori seguenti.

Valore	Significato
WDS_CLI_MSG_START 0	Messaggio di avvio del trasferimento. Il parametro lParam è un puntatore a un valore LARGE_INTEGER contenente le dimensioni del file del trasferimento.
WDS_CLI_MSG_COMPLETE 1	Messaggio di trasferimento completo. Il parametro lParam è un valore HRESULT .
WDS_CLI_MSG_PROGRESS 2	Messaggio di stato del trasferimento. Il parametro lParam è un valore ULONG che corrisponde alla percentuale di trasferimento completato.
WDS_CLI_MSG_TEXT 3	Messaggio informativo. Il parametro lParam è puntatore a una stringa di debug che può essere usata a scopo diagnostico.

[in, optional] wParam

Questo parametro del messaggio deve essere sempre impostato sul valore dell'handle di trasferimento restituito dalla funzione WdsCliTransferImage o WdsCliTransferFile .

[in, optional] lParam

Il significato del valore contenuto da questo parametro dipende dal parametro dwMessageId .

[in, optional] pvUserData

Puntatore alle informazioni utente facoltative associate a questa sessione dalla funzione WdsCliTransferImage o WdsCliTransferFile .

Valore restituito

nessuno

Osservazioni

Una funzione di callback può chiamare la funzione WdsCliCancelTransfer per annullare un trasferimento. Sebbene una funzione di callback possa anche chiamare la funzione WdsCliWaitForTransfer , questa operazione non è consigliata perché non verranno ricevuti callback aggiuntivi finché il callback corrente non viene sbloccato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wdsclientapi.h

Condividi tramite