Compartilhar via

Função MesEncodeIncrementalHandleCreate (midles.h)

  • Artigo

A função MesEncodeIncrementalHandleCreate cria uma codificação e a inicializa para o estilo incremental de serialização.

Sintaxe

RPC_STATUS MesEncodeIncrementalHandleCreate(
  void          *UserState,
  MIDL_ES_ALLOC AllocFn,
  MIDL_ES_WRITE WriteFn,
  handle_t      *pHandle
);

Parâmetros

UserState

Ponteiro para o objeto de estado fornecido pelo usuário que coordena as funções Alloc, Write e Read fornecidas pelo usuário.

AllocFn

Ponteiro para a função Alloc fornecida pelo usuário.

WriteFn

Ponteiro para a função Write fornecida pelo usuário.

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 função MesEncodeIncrementalHandleCreate é usada por aplicativos para criar e inicializar o identificador para o estilo incremental de codificação ou decodificação. Ao usar o estilo incremental de codificação, o usuário fornece uma função Alloc para fornecer um buffer vazio no qual os dados codificados são colocados e uma função Write para chamar quando o buffer está cheio ou a codificação é concluída. Para obter informações adicionais sobre as funções Alloc, Write e Read fornecidas pelo usuário, consulte Serviços de Serialização.

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

Alloc

MesBufferHandleReset

MesHandleFree

MesIncrementalHandleReset