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