Функция GetHGlobalFromILockBytes (coml2api.h)

  • Статья

Функция GetHGlobalFromILockBytes извлекает дескриптор глобальной памяти в объект массива байтов, созданный с помощью функции CreateILockBytesOnHGlobal .

Синтаксис

HRESULT GetHGlobalFromILockBytes(
  [in]  LPLOCKBYTES plkbyt,
  [out] HGLOBAL     *phglobal
);

Параметры

[in] plkbyt

Указатель на интерфейс ILockBytes в объекте массива байтов, ранее созданном при вызове функции CreateILockBytesOnHGlobal .

[out] phglobal

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

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

Эта функция возвращает HRESULT.

Комментарии

После вызова Метода CreateILockBytesOnHGlobal, который создает объект массива байтов в глобальной памяти, GetHGlobalFromILockBytes получает указатель на дескриптор глобальной памяти, лежащий в основе объекта массива байтов. Дескриптор, возвращающийся этой функцией, может отличаться от исходного дескриптора из-за промежуточных вызовов функции GlobalReAlloc .

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

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

Требования

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

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

CreateILockBytesOnHGlobal

StgOpenStorage