mesBufferHandleReset 函数 (midles.h)

  • 项目

MesBufferHandleReset 函数重新初始化缓冲区序列化的句柄。

语法

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

parameters

Handle

要初始化的句柄。

HandleStyle

句柄样式。 有效样式 MES_FIXED_BUFFER_HANDLE 或 MES_DYNAMIC_BUFFER_HANDLE。

Operation

操作代码。 有效代码是 MES_ENCODE、 MES_ENCODE_NDR64或 MES_DECODE。

pBuffer

对于 MES_DECODE，指针指向包含要解码的数据的缓冲区的指针。

对于 MES_ENCODE，指针指向 指向固定缓冲区样式的缓冲区的指针，以及指向用于返回 序列化动态缓冲区样式的缓冲区地址的指针。

对于 MES_ENCODE_NDR64，指针指向固定缓冲区样式缓冲区的指针，以及指向用于返回动态缓冲区序列化样式的缓冲区地址的指针，但显式使用 NDR64 对缓冲区进行编码。 用户提供的缓冲区必须与 16 对齐。

BufferSize

缓冲区中要解码的数据字节数。 请注意，这仅用于序列化的固定缓冲区样式。

pEncodedSize

指向已完成编码的大小的指针。 请注意，仅当操作 MES_ENCODE 或 MES_ENCODE_NDR64时才使用。

返回值

值 含义
RPC_S_OK
 调用成功。
RPC_S_INVALID_ARG
 参数无效。
 
注意 有关有效错误代码的列表，请参阅 RPC 返回值。
 

注解

应用程序使用 MesBufferHandleReset 例程来重新初始化缓冲区样式句柄并保存内存分配。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 midles.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

另请参阅

MesEncodeDynBufferHandleCreate

MesEncodeFixedBufferHandleCreate

MesHandleFree