Поделиться через


Функция LocalHandle (winbase.h)

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

Примечание Локальные функции имеют большую нагрузку и предоставляют меньше возможностей, чем другие функции управления памятью. Новые приложения должны использовать функции кучи , если в документации не указано, что следует использовать локальную функцию. Дополнительные сведения см. в разделе Глобальные и локальные функции.
 

Синтаксис

HLOCAL LocalHandle(
  [in] LPCVOID pMem
);

Параметры

[in] pMem

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

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

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

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Когда функция LocalAlloc выделяет локальный объект памяти с LMEM_MOVEABLE, она возвращает дескриптор объекту . Функция LocalLock преобразует этот дескриптор в указатель на блок памяти объекта, а LocalHandle преобразует указатель обратно в дескриптор.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

Глобальные и локальные функции

LocalAlloc

LocalLock

Функции управления памятью