PFN_WdsCliCallback función de devolución de llamada (wdsclientapi.h)

Define una función de devolución de llamada que WDS puede llamar a mensajes de error y notificación de progreso durante una transferencia de archivos o imágenes.

Sintaxis

PFN_WdsCliCallback PfnWdsclicallback;

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

Parámetros

[in] dwMessageId

Tipo de mensaje y significado del parámetro lParam .

Este parámetro solo puede tener uno de los valores siguientes.

Valor	Significado
WDS_CLI_MSG_START 0	Mensaje de inicio de transferencia. El parámetro lParam es un puntero a un valor de LARGE_INTEGER que contiene el tamaño del archivo de la transferencia.
WDS_CLI_MSG_COMPLETE 1	Mensaje completo de transferencia. El parámetro lParam es un valor HRESULT .
WDS_CLI_MSG_PROGRESS 2	Mensaje de progreso de transferencia. El parámetro lParam es un valor ULONG que es el porcentaje de transferencia completada.
WDS_CLI_MSG_TEXT 3	Mensaje informativo. El parámetro lParam es puntero a una cadena de depuración que se puede usar con fines de diagnóstico.

[in, optional] wParam

Este parámetro de mensaje siempre debe establecerse en el valor del identificador de transferencia devuelto por la función WdsCliTransferImage o WdsCliTransferFile .

[in, optional] lParam

El significado del valor contenido por este parámetro depende del parámetro dwMessageId .

[in, optional] pvUserData

Puntero a la información de usuario opcional adjunta a esta sesión mediante la función WdsCliTransferImage o WdsCliTransferFile .

Valor devuelto

None

Observaciones

Una función de devolución de llamada puede llamar a la función WdsCliCancelTransfer para cancelar una transferencia. Aunque una función de devolución de llamada también puede llamar a la función WdsCliWaitForTransfer , esto no se recomienda porque no se recibirán devoluciones de llamada adicionales hasta que se desbloquee la devolución de llamada actual.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wdsclientapi.h