nl :: Tecer:: Perfis :: BDX_Development

Esse manipulador é chamado sempre que um erro Weave é encontrado e não pode ser retornado diretamente por meio de códigos de erro para o fluxo de controle definido pelo aplicativo do usuário.

Ou seja, se ocorrer um erro em outro manipulador cuja assinatura tenha tipo de retorno void (por exemplo, em resposta a uma mensagem Weave recebida ou mesmo despachado pelo protocolo), este manipulador será chamado para que o usuário possa determinar se a transferência pode ser recuperada e continuar ou se eles devem chamar Shutdown (). Note que é possível que um erro ocorra antes de uma BDXTransfer é inicializado (por exemplo, já muitos objetos de transferência alocados). Nesse caso, o referido erro será registrado pelo Weave e o protocolo tratará da limpeza de qualquer estado necessário que tenha alocado.

Get a block of data to be transmitted.

O chamador fornece o espaço de buffer (buffer e comprimento do buffer, passado por referência). O Callee (aplicativo do usuário) DEVE usar o buffer fornecido, mas por motivos de compatibilidade com versões anteriores, pode retornar seu próprio buffer. Receptor não deve fornecer mais do que o aLength de bytes. Em retorno, aLength contém o número real de bytes lidos na memória intermédia.

Manipula o bloco de dados apontado por aDataBlock de comprimento aLength.

Provavelmente, isso envolverá gravá-lo em um arquivo e fechar esse arquivo se isLastBlock for verdadeiro.

Callback invocado quando um enviado anteriormente ReceiveInit é aceito pelo destino.

Você pode querer usar esta oportunidade para abrir arquivos ou alocar recursos para a transferência, caso não o tenha feito ao iniciá-la.

Callback invocado quando receber uma ReceiveInit mensagem.

Seu trabalho é determinar se você deseja aceitar o Recebimento e, em caso afirmativo, defina aXfer-> mIsAccepted = true para que o protocolo envie uma mensagem de aceitação ao iniciador. O BDXTransfer objeto é iniciada com as configurações padrão. Este é um bom lugar para anexar qualquer estado específico do aplicativo (identificadores de arquivo aberto, etc.) para aXfer-> mAppState. Você também deve anexar os manipuladores necessários para manuseio de blocos por exemplo, para o BDXTransfer objeto neste momento. Se um código de erro diferente de kStatus_Success for retornado, a transferência será considerada rejeitada e o protocolo tratará do envio de uma mensagem de rejeição com o código.

Chamado se uma das mensagens iniciais anteriores foi rejeitada pelo destino.

Callback invocado quando um enviado anteriormente SendInit é aceito pelo destino.

Você pode querer usar esta oportunidade para abrir arquivos ou alocar recursos para a transferência, caso não o tenha feito ao iniciá-la.

Callback invocado quando receber uma SendInit mensagem.

Sua função é determinar se você deseja aceitar a SendInit e, em caso afirmativo, definir aXfer-> mIsAccepted = true para que o protocolo irá enviar uma mensagem de aceitar para o iniciador. O BDXTransfer objeto é iniciada com as configurações padrão. Este é um bom lugar para anexar qualquer estado específico do aplicativo (identificadores de arquivo aberto, etc.) para aXfer-> mAppState. Você também deve anexar os manipuladores necessários para manuseio de blocos por exemplo, para o BDXTransfer objeto neste momento. Se um código de erro diferente de WEAVE_NO_ERROR for retornado, a transferência será considerada rejeitada e o protocolo tratará do envio de uma mensagem de rejeição com o código.

Trate os casos em que a transferência é concluída.

Handle TransferError mensagens recebidas ou enviadas por BDX.

Nota: A transferência BDX se presume ser potencialmente recuperáveis (por exemplo, possivelmente temporária fora do PacketBuffers no momento) e por isso a opção de chamar Shutdown () é deixado para o programador da aplicação e os retornos de chamada que definem. TODO: verifique isso e reconcilie-o com o idioma no documento BDX, que afirma: "[A TransferError] Pode ser enviado a qualquer momento por qualquer uma das partes para encerrar prematuramente a transferência de dados em massa."

GetBDXAckFlag retorna o sinalizador apropriado para o campo RequestAck dependendo da conexão do contexto de troca (sem confirmação de solicitação para TCP) e com base no suporte de tempo de compilação para WRMP.