LocalDiscard

Функция LocalDiscard разрушает указанный объект глобальной памяти, сохраняя его дескриптор. Количество блокировок объекта должно быть нулевым.

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

function LocalDiscard(
  h: THandle    // дескриптор объекта локальной памяти
): THandle;

Параметры

h [in]
Дескриптор объекта в локальной памяти. Должен быть получен путем вызова одной из функций LocalAlloc или LocalReAlloc.

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

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

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

Описание

Несмотря на то, что функция разрушает объект в памяти, дескриптор объекта остается правильным. Впоследствии процесс может передать этот дескриптор функции LocalReAlloc для того, чтобы выделить память, связанную с тем же самым дескриптором.

Реализована в Delphi как вызов функции LocalReAlloc с новым значением размера, равным 0 и флагом LMEM_MOVEABLE, и не содержиться ни в одной из стандартных DLL Windows.

Требования

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

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

LocalCompact

LocalFlags

© Mystic, 2002