Функция NdrConformantArrayUnmarshall (rpcndr.h)

Статья
08/25/2023

Функция NdrConformantArrayUnmarshall отменяет удаление соответствующего массива.

Синтаксис

unsigned char * NdrConformantArrayUnmarshall(
  [in]  PMIDL_STUB_MESSAGE pStubMsg,
  [out] unsigned char      **ppMemory,
  [in]  PFORMAT_STRING     pFormat,
  [in]  unsigned char      fMustAlloc
);

Параметры

[in] pStubMsg

Указатель на структуру MIDL_STUB_MESSAGE , которая поддерживает текущее состояние заглушки RPC. Эта структура предназначена только для внутреннего использования и не должна изменяться.

[out] ppMemory

Адрес указателя на буфер, в котором не соответствует требованиям массив. Если задано значение NULL или если fMustAlloc имеет значение TRUE, заглушка выделяет память.

[in] pFormat

Указатель на описание строки формата.

[in] fMustAlloc

Флаг, указывающий, должна ли заглушка выделять память, в которую должен быть маршалирован соответствующий массив. Укажите ЗНАЧЕНИЕ TRUE , если RPC должен выделять ppMemory.

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

Возвращает значение NULL при успешном выполнении. При возникновении ошибки функция выдает один из следующих кодов исключений.

Код возврата	Описание
RPC_BAD_STUB_DATA	Неправильная сеть.
RPC_X_INVALID_BOUND	Неправильная сеть.
RPC_S_OUT_OF_MEMORY	Системе не хватает памяти.
STATUS_ACCESS_VIOLATION	Произошло нарушение доступа.
RPC_S_INTERNAL_ERROR	В RPC произошла ошибка.

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

NdrConformantArrayUnmarshall следует вызывать только в контексте заглушки RPC после инициализации заглушки клиента или сервера.

Примеры

void  ConfArray([in] long size,
        [in,size_is(size)] long *pArray);         // conformant array

Требования


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

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