Função MesEncodeDynBufferHandleCreate (midles.h)

A função MesEncodeDynBufferHandleCreate cria um identificador de codificação e, em seguida, inicializa-o para um estilo de buffer dinâmico de serialização.

Sintaxe

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

Parâmetros

pBuffer

Ponteiro para um ponteiro para o buffer fornecido por stub que contém a codificação após a conclusão da serialização.

pEncodedSize

Ponteiro para o tamanho da codificação concluída. O tamanho será gravado no local de memória apontado por pEncodedSize por operações de codificação subsequentes.

pHandle

Ponteiro para o endereço no qual o identificador será gravado.

Valor retornado

Comentários

A rotina MesEncodeDynBufferHandleCreate é usada por aplicativos para alocar a memória e inicializar o identificador para o estilo de buffer dinâmico de codificação. Ao usar o estilo de buffer dinâmico de codificação, o buffer no qual todos os dados codificados serão colocados é fornecido pelo stub. Esse buffer será alocado pelo mecanismo de gerenciamento de memória do cliente atual.

Pode haver implicações de desempenho ao usar esse estilo para várias codificações com o mesmo identificador. Um único buffer é retornado de uma codificação e os dados são copiados de buffers intermediários. Os buffers são liberados quando necessário.

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

MesHandleFree