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

Статья
08/24/2023

Функция 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

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