LocalHandle

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

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

function LocalHandle(
  Mem: Pointer         // указатель на начало блока локальной памяти
): HLOCAL; stdcall;

Параметры

Mem [in]
Указатель на начало блока глобальной памяти. Указатель должен быть получен функцией LocalLock.

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

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

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

Описание

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

По непонятным причинам функция не описана в Delphi.

Требования

Windows NT/2000: Требуется Windows NT 3.1 или более поздняя версия
Windows 95/98: Требуется Windows 95 или более поздняя версия
Бибиотека: Kernel32.dll
Подключаемый модуль: Не описана

Смотри также:

LocalFree

LocalLock

© Mystic, 2002