Compartilhar via

Função MesEncodeDynBufferHandleCreate (midles.h)

  • Artigo

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

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_INVALID_ARG
 O argumento era inválido.
RPC_S_OUT_OF_MEMORY
 Sem memória.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

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

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho midles.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

MesBufferhandleReset

MesHandleFree