Compartilhar via

Função MesEncodeFixedBufferHandleCreate (midles.h)

  • Artigo

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

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 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

Requisito Valor
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

MesDecodeBufferHandleCreate

MesHandleFree