nl::Weave::Profiles::BDX_Development

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

Ou seja, se ocorrer um erro em outro manipulador cuja assinatura tenha o tipo de retorno nulo (por exemplo, em resposta a uma mensagem do Weave recebida ou mesmo despachada pelo protocolo), esse manipulador será chamado para que o usuário possa determinar se a transferência pode ser recuperada e continuar ou se ele deve chamar Shutdown(). É possível que um erro ocorra antes da inicialização de BDXTransfer (por exemplo, já há muitos objetos de transferência alocados). Nesse caso, esse erro será registrado pelo Weave e o protocolo tratará a limpeza de qualquer estado necessário alocado.

Get a block of data to be transmitted.

O autor da chamada fornece o espaço de armazenamento em buffer (buffer e comprimento do buffer, transmitidos por referência). O recebedor da chamada (aplicativo do usuário) DEVE usar o buffer fornecido, mas, por motivos de compatibilidade com versões anteriores, pode retornar o próprio buffer. O recebedor da chamada não pode fornecer mais do que aLength de bytes. Ao retornar, aLength contém o número real de bytes lidos no buffer.

Processa o bloco de dados apontado por um aDataBlock de comprimento aLength.

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

Chamada de retorno invocada quando um ReceiveInit enviado anteriormente é aceito pelo destino.

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

Chamada de retorno invocada ao receber uma mensagem ReceiveInit.

Seu trabalho é determinar se você deseja aceitar o receive e, em caso afirmativo, definir aXfer->mIsAccepted=true para que o protocolo envie uma mensagem de aceitação para o iniciador. O objeto BDXTransfer é iniciado para as configurações padrão. Esse é um bom lugar para anexar qualquer estado específico do aplicativo (identificadores de arquivos abertos etc.) a aXfer->mAppState. Você também deve anexar os gerenciadores necessários para, por exemplo, processamento de blocos para o 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á o envio de uma mensagem de rejeição com o código.

Invocado se uma das mensagens Init anteriores foi rejeitada pelo destino.

Chamada de retorno invocada quando um SendInit enviado anteriormente é aceito pelo destino.

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

Chamada de retorno invocada ao receber uma mensagem SendInit.

Sua função é determinar se você quer aceitar SendInit e, em caso afirmativo, definir aXfer->mIsAccepted=true para que o protocolo envie uma mensagem de aceitação para o iniciador. O objeto BDXTransfer é iniciado para as configurações padrão. Esse é um bom lugar para anexar qualquer estado específico do aplicativo (identificadores de arquivos abertos etc.) a aXfer->mAppState. Você também deve anexar os gerenciadores necessários para, por exemplo, processamento de blocos para o 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á o envio de uma mensagem de rejeição com o código.

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

Processa mensagens TransferError recebidas ou enviadas pelo BDX.

Observação: presume-se que a transferência BDX seja potencialmente recuperável (possivelmente temporária, por exemplo, fora dos PackageBuffers no momento) e, portanto, a opção de chamar Shutdown() é deixada para o programador do aplicativo e para os callbacks definidos por ele. PENDENTE: verifique e reconcilie isso com o idioma do documento BDX, que afirma: "[A TransferError] Pode ser enviado a qualquer momento por qualquer uma das partes para prematuramente finalizar a transferência de dados em massa".

GetBDXAckFlag retorna a flag apropriada 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 ao tempo de compilação para WRMP.