Функция GlobalHandle (winbase.h)
Извлекает дескриптор, связанный с указанным указателем на глобальный блок памяти.
Примечание Глобальные функции имеют большую нагрузку и предоставляют меньше функций, чем другие функции управления памятью. Новые приложения должны использовать функции кучи , если в документации не указано, что следует использовать глобальную функцию. Дополнительные сведения см. в разделе Глобальные и локальные функции.
Синтаксис
HGLOBAL GlobalHandle(
[in] LPCVOID pMem
);
Параметры
[in] pMem
Указатель на первый байт глобального блока памяти. Этот указатель возвращается функцией GlobalLock .
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение является дескриптором указанного объекта глобальной памяти.
Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Когда функция GlobalAlloc выделяет объект памяти с GMEM_MOVEABLE, она возвращает дескриптор объекту . Функция GlobalLock преобразует этот дескриптор в указатель на блок памяти, а GlobalHandle преобразует указатель обратно в дескриптор.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winbase.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |