IReplObjHandler::GetPacket
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método é um método User-implemented que serializa um objeto em um ou mais pacotes para transmissão entre o dispositivo baseado em Windows Embedded CE e a computador desktop.
Syntax
HRESULT GetPacket(
LPBYTE* lppbData,
DWORD* pcbData,
DWORD cbRecommend
);
Parameters
- lppbData
[no] Ponteiro longo para um ponteiro da de saída pacote.
- pcbData
[no] Ponteiro para um DWORD para tamanho de pacote.
- cbRecommend
[no] Recomendável tamanho máximo do pacote.
Return Value
A seguinte tabela mostra as possíveis valores para este método retorna.
| Value | Description |
|---|---|
NOERROR |
A operação criado um pacote. |
RERR_BAD_OBJECT |
Falha de operação para criar um objeto. Se o destinatário receber alguns dos pacotes anteriores, eles devem ser descartados. |
RERR_TRY_AGAIN |
Falha de operação para criar um objeto. O servidor deve tentar novamente mais tarde para replicar o objeto. |
RERR_VOL_INACTIVE |
O volume tornou inativo. |
RWRN_LAST_PACKET |
Um pacote criado e ele é o último para o objeto. |
Remarks
Durante desserialização, chama o Gerenciador ActiveSync GetPacket repetidamente até que RWRN_LAST_OBJECT ou um valor de erro é retornado. O provedor serviço ActiveSync determina quantos pacotes devem ser enviados e os tamanhos de cada pacote. Para eficiência, é recomendável tamanho pacote seja Less than 8KB.
Alocação e desalocação de memória para o pacote é de responsabilidade do provedor de serviço ActiveSync. Define um provedor serviço ActiveSync lppbData Para esse ponteiro e conjuntos pcbData com tamanho de pacote. Normalmente, um provedor serviço ActiveSync aloca um pedaço de memória de um tamanho conhecido no IReplObjHandler::Setup e libera-lo no IReplObjHandler::Reset.
Requirements
| Header | cesync.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |