Função MesEncodeFixedBufferHandleCreate (midles.h)

A função MesEncodeFixedBufferHandleCreate cria um identificador de codificação e, em seguida, inicializa-o para um estilo de buffer fixo de serialização.

Sintaxe

RPC_STATUS MesEncodeFixedBufferHandleCreate(
  char          *pBuffer,
  unsigned long BufferSize,
  unsigned long *pEncodedSize,
  handle_t      *pHandle
);

Parâmetros

pBuffer

Ponteiro para o buffer fornecido pelo usuário.

BufferSize

Tamanho do buffer fornecido pelo usuário, em bytes.

pEncodedSize

Ponteiro para o tamanho da codificação concluída. O tamanho será gravado no pointee pelas operações de codificação subsequentes.

pHandle

Ponteiro para o identificador recém-criado.

Valor retornado

Comentários

A rotina MesEncodeFixedBufferHandleCreate é usada por aplicativos para criar e inicializar o identificador para o estilo de buffer fixo de codificação. Ao usar o estilo de buffer fixo de codificação, o usuário fornece um único buffer no qual todos os dados codificados são colocados. Esse buffer deve ter um endereço alinhado a 8 e deve ser um múltiplo de 8 bytes de tamanho. Além disso, ele deve ser grande o suficiente para conter uma codificação de todos os dados, juntamente com um cabeçalho de codificação para cada rotina sendo codificada.

Quando o identificador é usado para várias operações de codificação, o tamanho codificado é cumulativo.

Quando um stub é compilado usando -protocol all ou -protocol ndr64 e o buffer deve ser codificado usando a sintaxe de transferência NDR64, a função MesBufferHandleReset deve ser chamada com seu parâmetro OpCode definido como MES_ENCODE_NDR64.

Requisitos

Confira também

MesBufferhandleReset

MesDecodeBufferHandleCreate

MesHandleFree