Compartilhar via

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

  • Artigo

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