Функция CoReleaseMarshalData (combaseapi.h)

Статья
08/22/2023

Уничтожает ранее маршалированные пакеты данных.

Синтаксис

HRESULT CoReleaseMarshalData(
  [in] LPSTREAM pStm
);

Параметры

[in] pStm

Указатель на поток, содержащий пакет данных, который требуется уничтожить. См. раздел IStream.

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

Эта функция может возвращать стандартные возвращаемые значения E_FAIL, E_INVALIDARG, E_OUTOFMEMORY и E_UNEXPECTED, а также следующие значения.

Код возврата	Описание
S_OK	Пакет данных был успешно уничтожен.
STG_E_INVALIDPOINTER	Ошибка, связанная с параметром pStm .
CO_E_NOTINITIALIZED	Функция CoInitialize или OleInitialize не была вызвана в текущем потоке до вызова этой функции.

Функция считывает CLSID из потока.
Если используется реализация маршалинга COM по умолчанию, функция получает указатель IMarshal на экземпляр стандартного unmarshaler. Если используется настраиваемое маршалинг, функция создает прокси-сервер, вызывая функцию CoCreateInstance , передавая идентификатор CLSID, который он считывает из потока, и запрашивает указатель интерфейса IMarshal к только что созданному прокси-серверу.
Используя любой указатель интерфейса IMarshal , который он получил, функция вызывает IMarshal::ReleaseMarshalData.

Обычно эта функция не вызывается. Единственная ситуация, в которой может потребоваться вызвать эту функцию, — это использование пользовательского маршалинга (написание и использование собственной реализации IMarshal). Примеры вызова CoReleaseMarshalData включают следующие ситуации:

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

В качестве аналогии пакет данных можно рассматривать как ссылку на исходный объект так же, как если бы это был другой указатель интерфейса, удерживаемый на объекте. Как и реальный указатель интерфейса, этот пакет данных должен быть освобожден в какой-то момент. Использование IMarshal::ReleaseMarshalData для выпуска пакетов данных аналогично использованию указателей интерфейса IUnknown::Release для выпуска.

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

Важно Для маршалинга объекта в поток необходимо вызвать функцию CoReleaseMarshalData в том же объекте, что и CoMarshalInterface . Сбой может привести к утечке ссылки на объект, хранящиеся в маршалированных пакетах в потоке.

Требования

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

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

IMarshal::ReleaseMarshalData

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