Блокирует дескриптор блока памяти, чтобы его нельзя было перемещать, когда в Visual FoxPro требуется провести реорганизацию памяти.
|
|---|
void _HLock(MHANDLE hand)
MHANDLE hand; /* Дескриптор блока памяти. */ |
Примечания
Пример
В следующем примере на экране отображается символьный параметр. С помощью _HandToPtr( ) дескриптор блока памяти этого API-параметра транслируется в указатель языка C. Поскольку Visual FoxPro может инициировать реорганизацию памяти в ходе вызова _PutStr( ), то для гарантии правильной работы дескриптор блокируется с помощью _HLock( ). В конце процедуры вызывается программа _HUnLock( ), поскольку блокировка дескрипторов блоков памяти может неблагоприятно отразиться на производительности Visual FoxPro.
Код Visual FoxPro
| |  Copy Code |
|---|
SET LIBRARY TO HLOCK
= HLOCK("Hello, world.") && displays "Hello, world" on screen |
Код C
| | Copy Code |
|---|
#include <pro_ext.h>
void NullTerminate(Value FAR *cVal)
{
if (!_SetHandSize(cVal->ev_handle, cVal->ev_length + 1))
{
_Error(182); // "Insufficient memory"
}
((char FAR *) _HandToPtr(cVal->ev_handle))[cVal->ev_length] = '\0';
}
FAR Example(ParamBlk FAR *parm)
{
NullTerminate(&parm->p[0].val);
_HLock(parm->p[0].val.ev_handle);
_PutStr(_HandToPtr(parm->p[0].val.ev_handle));
_HUnLock(parm->p[0].val.ev_handle);
}
FoxInfo myFoxInfo[] = {
{"HLOCK", (FPFI) Example, 1, "C"},
};
FoxTable _FoxTable = {
(FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
}; |
Смотрите также
