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 o tipo de retorno void (por exemplo, em resposta a uma mensagem Weave de entrada 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 (). Observe que é possível que ocorra um erro antes de uma BDXTransfer ser inicializada (por exemplo, muitos objetos de transferência já 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). Callee (aplicativo do usuário) DEVE usar o buffer fornecido, mas por razões de compatibilidade com versões anteriores, pode retornar seu próprio buffer. O Callee não deve fornecer mais do que aLength de bytes. No retorno, aLength contém o número real de bytes lidos no buffer.

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.

Retorno de chamada invocado quando um ReceiveInit enviado anteriormente é 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.

Retorno de chamada invocado ao receber uma mensagem ReceiveInit .

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 objeto BDXTransfer é iniciado 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, por exemplo, manipulação de blocos ao objeto BDXTransfer neste ponto. 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.

Retorno de chamada invocado quando um SendInit enviado anteriormente é aceito pelo destino.

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

Retorno de chamada invocado ao receber uma mensagem SendInit .

Seu trabalho é determinar se você deseja aceitar SendInit e, em caso afirmativo, defina aXfer-> mIsAccepted = true para que o protocolo envie uma mensagem de aceitação ao iniciador. O objeto BDXTransfer é iniciado 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, por exemplo, manipulação de blocos ao objeto BDXTransfer neste ponto. 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.

Trate as mensagens TransferError recebidas ou enviadas por BDX.

Nota: A transferência BDX é presumida como potencialmente recuperável (possivelmente temporária, por exemplo, fora do PacketBuffers no momento) e, portanto, a opção de chamar Shutdown () é deixada para o programador do aplicativo e os callbacks que eles 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.