_HandToPtr( ) (Rutina de biblioteca API)

Convierte un controlador de memoria a un puntero FAR (de 32-bits) que señala a la memoria asignada a este controlador.

void FAR * _HandToPtr(MHANDLE hand)
MHANDLE hand;            /* Memory handle. */

Observaciones

Visual FoxPro puede reorganizar la memoria en cualquier momento en que el control se le transfiera a él o a otra rutina que no pertenezca al módulo actual.

**Nota   **_HandToPtr( ) no provoca la reorganización de la memoria. El puntero devuelto por _HandToPtr( ) puede dejar de ser válido cuando el control se vuelva a transferir a Visual FoxPro, a menos que el controlador MHANDLE esté bloqueado. No conserve punteros a controladores de memoria no bloqueados a través de llamadas de función externas, a menos que sepa con seguridad que la llamada no origina la reorganización de la memoria.

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.

Código Visual FoxPro

SET LIBRARY TO HANDTOPT
= HANDTOPTR("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[] = {
   {"HANDTOPTR", (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) | _HLock( ) (Rutina de biblioteca API) | _HUnLock( ) | _MemAvail( ) (Rutina de biblioteca API) | _SetHandSize( ) (Rutina de biblioteca API) | Acceso a la API de Visual FoxPro