Serialização de buffer fixa
Ao usar o estilo de buffer fixo, especifique um buffer grande o suficiente para acomodar as operações de codificação (marshalling) executadas com o identificador. Ao cancelar a gravação, você fornece o buffer que contém todos os dados a serem decodificados.
O estilo de buffer fixo de serialização usa as seguintes rotinas:
A função MesEncodeFixedBufferHandleCreate aloca a memória necessária para o identificador de codificação e a inicializa. O aplicativo pode chamar MesBufferHandleReset para reinicializar o identificador ou pode chamar MesHandleFree para liberar a memória do identificador. Para criar um identificador de decodificação correspondente ao identificador de codificação de estilo fixo, você deve usar MesDecodeBufferHandleCreate.
O aplicativo chama MesHandleFree para liberar o identificador de buffer de codificação ou decodificação.
Exemplos de codificação de buffer fixo
A seção a seguir fornece um exemplo de como usar um identificador de serialização de estilo de buffer fixo para codificação de procedimento.
/*This is a fragment of the IDL file defining MooProc */
...
void __RPC_USER
MyProc( [in] handle_t Handle, [in,out] MyType * pMyObject,
[in, out] ThisType * pThisObject);
...
/*This is an ACF file. MyProc is defined in the IDL file */
[
explicit_handle
]
interface regress
{
[ encode,decode ] MyProc();
}
O trecho a seguir representa uma parte de um aplicativo.
if (MesEncodeFixedBufferHandleCreate (
Buffer, BufferSize,
pEncodedSize, &Handle) == RPC_S_OK)
{
...
/* Manufacture a MyObject and a ThisObject */
...
/* The serialization works from the beginning of the buffer because
the handle is in the initial state. The function MyProc does the
following when called with an encoding handle:
- sizes all the parameters for marshalling,
- marshalls into the buffer (and sets the internal state
appropriately)
*/
MyProc ( Handle, pMyObject, pThisObject );
...
MesHandleFree ();
}
if (MesDecodeBufferHandleCreate (Buffer, BufferSize, &Handle) ==
RPC_S_OK)
{
/* The MooProc does the following for you when called with a decoding
handle:
- unmarshalls the objects from the buffer into *pMooObject and
*pBarObject
*/
MyProc ( Handle, pMyObject, pThisObject);
...
MesHandleFree ( Handle );
}
A seção a seguir fornece um exemplo de como usar um identificador de serialização de estilo de buffer fixo para codificação de tipo.
/* This is an ACF file. MyType is defined in the IDL file */
[
explicit_handle
]
interface regress
{
typedef [ encode,decode ] MyType;
}
O trecho a seguir representa os fragmentos de aplicativo relevantes.
if (MesEncodeFixedBufferHandleCreate (Buffer, BufferSize,
pEncodedSize, &Handle) == RPC_S_OK)
{
//...
/* Manufacture a MyObject and a pMyObject */
//...
MyType_Encode ( Handle, pMyObject );
//...
MesHandleFree ();
}
if (MesDecodeBufferHandleCreate (Buffer, BufferSize, &Handle) ==
RPC_S_OK )
{
MooType_Decode (Handle, pMooObject);
//...
MesHandleFree ( Handle );
}