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