Поделиться через

Функция MesEncodeDynBufferHandleCreate (midles.h)

  • Статья

Функция MesEncodeDynBufferHandleCreate создает дескриптор кодирования, а затем инициализирует его для динамического стиля буфера сериализации.

Синтаксис

RPC_STATUS MesEncodeDynBufferHandleCreate(
  char          **pBuffer,
  unsigned long *pEncodedSize,
  handle_t      *pHandle
);

Параметры

pBuffer

Указатель на указатель на буфер, предоставленный заглушками, содержащий кодировку после завершения сериализации.

pEncodedSize

Указатель на размер завершенной кодировки. Размер будет записан в расположение памяти, на который указывает pEncodedSize , путем последующих операций кодирования.

pHandle

Указатель на адрес, на который будет записан дескриптор.

Возвращаемое значение

Значение Значение
RPC_S_OK
 Вызов выполнен успешно.
RPC_S_INVALID_ARG
 Недопустимое значение аргумента.
RPC_S_OUT_OF_MEMORY
 Недостаточно памяти.
 
Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.
 

Комментарии

Подпрограмма MesEncodeDynBufferHandleCreate используется приложениями для выделения памяти и инициализации дескриптора для динамического буферного стиля кодирования. При использовании динамического стиля кодирования буфер, буфер, в который будут помещены все закодированные данные, предоставляется заглушка. Этот буфер будет выделен текущим клиентским механизмом управления памятью.

Использование этого стиля для нескольких кодировок с одинаковым дескриптором может повлиять на производительность. Один буфер возвращается из кодировки, а данные копируются из промежуточных буферов. Буферы освобождаются при необходимости.

Если заглушка компилируется с использованием -protocol all или -protocol ndr64 и буфер должен быть закодирован с помощью синтаксиса передачи NDR64, необходимо вызвать функцию MesBufferHandleReset с параметром OpCode MES_ENCODE_NDR64.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header midles.h (включая Rpc.h)
Библиотека Rpcrt4.lib
DLL Rpcrt4.dll

См. также раздел

MesBufferhandleReset

MesHandleFree