Função MesBufferHandleReset (midles.h)

A função MesBufferHandleReset inicializa novamente o identificador para serialização de buffer.

Sintaxe

RPC_STATUS MesBufferHandleReset(
  handle_t      Handle,
  unsigned long HandleStyle,
  MIDL_ES_CODE  Operation,
  char          **pBuffer,
  unsigned long BufferSize,
  unsigned long *pEncodedSize
);

Parâmetros

Handle

Identificador a ser inicializado.

HandleStyle

Estilo de identificador. Estilos válidos são MES_FIXED_BUFFER_HANDLE ou MES_DYNAMIC_BUFFER_HANDLE.

Operation

Código de operação. Os códigos válidos são MES_ENCODE, MES_ENCODE_NDR64 ou MES_DECODE.

pBuffer

Para MES_DECODE, ponteiro para um ponteiro para o buffer que contém os dados a serem decodificados.

Para MES_ENCODE, ponteiro para um ponteiro para o buffer para estilo de buffer fixo e ponteiro para um ponteiro para retornar o endereço do buffer para o estilo de buffer dinâmico de serialização.

Para MES_ENCODE_NDR64, ponteiro para um ponteiro para o buffer para estilo de buffer fixo e ponteiro para um ponteiro para retornar o endereço do buffer para o estilo de buffer dinâmico de serialização, mas usa explicitamente NDR64 para codificar o buffer. O buffer fornecido pelo usuário deve ser alinhado a 16.

BufferSize

Bytes de dados a serem decodificados no buffer. Observe que isso é usado apenas para o estilo de buffer fixo de serialização.

pEncodedSize

Ponteiro para o tamanho da codificação concluída. Observe que isso é usado somente quando a operação é MES_ENCODE ou MES_ENCODE_NDR64.

Valor retornado

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

Comentários

A rotina MesBufferHandleReset é usada por aplicativos para inicializar novamente um identificador de estilo de buffer e salvar alocações de memória.

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

MesEncodeDynBufferHandleCreate

MesEncodeFixedBufferHandleCreate

MesHandleFree