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

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

  • Статья

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

Синтаксис

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

Параметры

pBuffer

Указатель на предоставленный пользователем буфер.

BufferSize

Размер предоставленного пользователем буфера в байтах.

pEncodedSize

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

pHandle

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

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

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

Комментарии

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

Если дескриптор используется для нескольких операций кодирования, закодированный размер является накопительным.

Если заглушка компилируется с использованием -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

MesDecodeBufferHandleCreate

MesHandleFree