_FreeObject( ), API-Bibliotheksroutine

Gibt ein Objekt aus dem API-Datenpool in Visual FoxPro frei.

void _FreeObject(Value FAR *objct)

Hinweise

Verwenden Sie _FreeObject( ), wenn Sie ein Objekt aus der API-Objekttabelle in Visual FoxPro freigeben möchten.

_FreeObject( ) wird in folgenden Fällen verwendet:

1. Wenn eine API-Funktion in Visual FoxPro (z. B. _Evaluate( ) oder _GetObjectProperty( )) einen Objektverweis zurückgibt, müssen Sie _FreeObject( ) verwenden, um das Objekt freizugeben, wenn Sie nicht länger damit arbeiten.

2. Wenn Sie über verschiedene API-Aufrufe in Visual FoxPro hinweg einen Objektverweis aufrechterhalten möchten, müssen Sie zunächst _ObjectReference( ) aufrufen, um den Objektzähler zu erhöhen. Wenn Sie das Objekt nicht mehr benötigen, müssen Sie den Objektzähler mit _ObjectRelease( ) herabsetzen. Dann können Sie das Objekt mit _FreeObject( ) freigeben.

Über die vorgenannten Regeln hinaus sollten Sie immer die Struktur Value, die Sie an eine API-Funktion in Visual FoxPro übergeben, löschen, wenn die Funktion einen Wert in die übergebene Value-Struktur einträgt. Sie können z. B. eine Funktion erstellen und aufrufen, die die Struktur löscht, bevor eine Funktion aufgerufen wird, die einen Wert in diese Struktur zurückgibt. Sie haben auch die Möglichkeit, eine Funktion zu erstellen und aufzurufen, um alle Objektverweise oder nicht verwendete Handles zu löschen.

Solange kein Fehler auftritt, wird 0 zurückgegeben. Tritt ein Fehler auf, wird ein negativer Wert zurückgegeben, der einen internen Fehlercode darstellt.

Weitere Informationen zum Erstellen einer API-Bibliothek und ihrer Integration in Visual FoxPro finden Sie unter Zugreifen auf die Visual FoxPro-API.

Siehe auch

_ObjectReference( ), API-Bibliotheksroutine | _ObjectRelease( ), API-Bibliotheksroutine | _GetObjectProperty( ), API-Bibliotheksroutine | _Evaluate( ), API-Bibliotheksroutine