_FreeObject( ) (Rutina de biblioteca API)

Libera un objeto del conjunto de datos de la API de Visual FoxPro.

void _FreeObject(Value FAR *objct)

Observaciones

Utilice _FreeObject( ) para liberar un objeto de la tabla de objetos de la API de Visual FoxPro.

_FreeObject( ) se emplea en las situaciones siguientes:

1. Si se devuelve una referencia de objeto desde cualquier función de la API de Visual FoxPro (por ejemplo, _Evaluate( ) o _GetObjectProperty( )), debe utilizar _FreeObject( ) para liberar el objeto cuando ya no lo esté empleando.

2. Si conserva una referencia a un objeto entre distintas llamadas a la API de Visual FoxPro, debe utilizar en primer lugar _ObjectReference( ) para aumentar el contador del objeto. Cuando ya no esté utilizando el objeto, debe emplear _ObjectRelease( ) para disminuir el contador del objeto y, a continuación, debe utilizar _FreeObject( ) para liberar el objeto.

Además de las reglas anteriores, siempre debe limpiar la estructura Value que pasa a cualquier función de la API de Visual FoxPro que devuelve un valor a la estructura Value transferida. Por ejemplo, puede crear y llamar a una función que limpie la estructura antes de llamar a una función que devuelva un valor a su estructura. También puede crear y llamar a una función para limpiar las referencias a objetos o identificadores sin utilizar.

Devuelve 0 a menos que se produzca un error. Cuando se produce un error, se devuelve un número negativo que representa un código interno de error.

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.

Vea también

_ObjectReference( ) (Rutina de biblioteca API) | _ObjectRelease( ) (Rutina de biblioteca API) | _GetObjectProperty( ) (Rutina de biblioteca API) | _Evaluate( ) (Rutina de biblioteca API)