_HLock( ) (Rutina de biblioteca API)
Bloquea un controlador de memoria para impedir que se mueva si Visual FoxPro necesita reorganizar la memoria.
void _HLock(MHANDLE hand)
MHANDLE hand; /* Memory handle. */
Observaciones
_HLock( ) no origina la reorganización de la memoria. Desbloquee el controlador MHANDLE en cuanto el bloqueo haya logrado su propósito.
Para obtener más información acerca de cómo crear una biblioteca API e integrarla con Visual FoxPro, vea Acceso a la API de Visual FoxPro.
Ejemplo
El siguiente ejemplo muestra en pantalla el parámetro de carácter. Utiliza _HandToPtr( ) para convertir el controlador de memoria del parámetro API a un puntero C. Dado que es posible que Visual FoxPro decida reorganizar la memoria durante la llamada a _PutStr( ), para garantizar que la ejecución sea correcta, el ejemplo bloquea el controlador de memoria con _HLock( ). El ejemplo también llama a _HUnLock( ) al final, ya que el rendimiento de Visual FoxPro se puede ver afectado negativamente por los controladores de memoria bloqueados.
Código Visual FoxPro
SET LIBRARY TO HLOCK
= HLOCK("Hello, world.") && displays "Hello, world" on screen
Código C
#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
};
Vea también
_AllocHand( ) (Rutina de biblioteca API) | _FreeHand( ) (Rutina de biblioteca API) | _GetHandSize( ) (Rutina de biblioteca API) | _HandToPtr( ) (Rutina de biblioteca API) | _HUnLock( ) (Rutina de biblioteca API) | _MemAvail( ) (Rutina de biblioteca API) | _SetHandSize( ) (Rutina de biblioteca API) | Acceso a la API de Visual FoxPro