Преобразует дескриптор блока памяти в указатель типа FAR (32-bit), который адресует память, закрепленную за данным дескриптором.
void FAR * _HandToPtr(MHANDLE hand) MHANDLE hand; /* Дескриптор блока памяти. */ |
Примечания
Visual FoxPro может реорганизовать память в любой момент, когда управление передается в систему или в другую программу вне текущего модуля.
Замечание |
---|
_HandToPtr() не вызывает реорганизации памяти. Указатель, возвращенный _HandToPtr() может стать недействительным в любой момент, когда управление возвращается в Visual FoxPro, если только дескриптор MHANDLE не заблокирован. Не оставляйте указатели на неблокированные дескрипторЫ действующими на все время работы внешней функции, если в документации не указано, что вызов этой функции не вызывает реорганизацию памяти. |
Для получения дополнительной информации о том, как создавать библиотеку API и интегрировать её в Visual FoxPro, смотрите Доступ к API Visual FoxPro.
Пример
В следующем примере на экране отображается символьный параметр. Используя _HandToPtr( ) дескриптор блока памяти этого API-параметра транслируется в указатель языка C.
Код Visual FoxPro
Copy Code | |
---|---|
SET LIBRARY TO HANDTOPT = HANDTOPTR("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[] = { {"HANDTOPTR", (FPFI) Example, 1, "C"}, }; FoxTable _FoxTable = { (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo }; |
Смотрите также
Справочное руководство
Процедура библиотеки API _AllocHand( )Процедура библиотеки API _FreeHand( )
Процедура библиотеки API _GetHandSize( )
Процедура библиотеки API _HLock( )
Процедура библиотеки API _HUnLock( )
Процедура библиотеки API _MemAvail( )
Процедура библиотеки API _SetHandSize( )
Прочие ресурсы
Конструкции библиотеки APIДоступ к API Visual FoxPro
c Microsoft Corporation. All rights reserved. Microsoft is not reponsible for the contents of the translated help topics.