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

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

Синтаксис

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

Параметры

[in] plkbyt

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

[out] phglobal

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

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

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

Комментарии

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

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

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

Требования

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

CreateILockBytesOnHGlobal

StgOpenStorage