PFN_WdsCliCallback função de retorno de chamada (wdsclientapi.h)

Define uma função de retorno de chamada que o WDS pode chamar para mensagens de notificação de progresso e de erro durante uma transferência de arquivo ou imagem.

Sintaxe

PFN_WdsCliCallback PfnWdsclicallback;

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

Parâmetros

[in] dwMessageId

O tipo de mensagem e o significado do parâmetro lParam .

Esse parâmetro pode ter apenas um dos valores a seguir.

Valor	Significado
WDS_CLI_MSG_START 0	A mensagem de início da transferência. O parâmetro lParam é um ponteiro para um valor LARGE_INTEGER que contém o tamanho do arquivo da transferência.
WDS_CLI_MSG_COMPLETE 1	A mensagem de transferência completa. O parâmetro lParam é um valor HRESULT .
WDS_CLI_MSG_PROGRESS 2	A mensagem de progresso da transferência. O parâmetro lParam é um valor ULONG que é a porcentagem de transferência concluída.
WDS_CLI_MSG_TEXT 3	A mensagem informativa. O parâmetro lParam é um ponteiro para uma cadeia de caracteres de depuração que pode ser usada para fins de diagnóstico.

[in, optional] wParam

Esse parâmetro de mensagem sempre deve ser definido como o valor do identificador de transferência retornado pela função WdsCliTransferImage ou WdsCliTransferFile .

[in, optional] lParam

O significado do valor contido por esse parâmetro depende do parâmetro dwMessageId .

[in, optional] pvUserData

Um ponteiro para informações opcionais do usuário anexadas a esta sessão pela função WdsCliTransferImage ou WdsCliTransferFile .

Retornar valor

Nenhum

Comentários

Uma função de retorno de chamada pode chamar a função WdsCliCancelTransfer para cancelar uma transferência. Embora uma função de retorno de chamada também possa chamar a função WdsCliWaitForTransfer , isso não é recomendado porque nenhum retorno de chamada adicional será recebido até que o retorno de chamada atual seja desbloqueado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wdsclientapi.h