Преобразует дескриптор блока памяти в указатель типа 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.
Замечание