ReleaseStringList
Sonstige Funktionen
Beschreibung
Gibt eine Zeichenfolgenliste frei, die zuvor von einer anderen API-Funktion zurückgegeben wurde, beispielsweise CheckFileCompliance. Nach diesem Aufruf ist das Handle StringListID nicht mehr gültig und darf nicht an GetStringListCount oder GetStringListItem übergeben werden.
Syntax
Delphi
Function TPDFlib.ReleaseStringList(StringListID: Integer): Integer;ActiveX
Function PDFlib::ReleaseStringList(StringListID As Long) As LongDLL
int DLReleaseStringList(int InstanceID, int StringListID);Parameter
| StringListID | Die ID der freizugebenden Zeichenfolgenliste, wie zuvor von einer Erzeugerfunktion zurückgegeben |
|---|
Rückgabewerte
| 0 | StringListID ist ungültig oder verweist nicht auf eine Zeichenfolgenliste, die dieser Instanz gehört |
|---|---|
| 1 | Die Liste wurde erfolgreich freigegeben |
Anmerkungen
Zeichenfolgenlisten gehören der PDFlib-Instanz, die sie erzeugt hat. Beim Zerstören der Instanz werden sie automatisch freigegeben, sodass eine explizite Freigabe normalerweise optional ist. Rufen Sie ReleaseStringList in lang laufenden Prozessen auf, die viele Listen erzeugen, beispielsweise einem CI-Worker, der Hunderte PDF-Dateien nacheinander validiert, um die Speichernutzung zu begrenzen
Beispiel
// Validate many files in a loop, releasing each result list as soon as it has been logged
var
I, Issues, Count, J: Integer;
begin
for I := 0 to Files.Count - 1 do
begin
Issues := PDF.CheckFileCompliance(Files[I], '', 1, 0);
if Issues <> 0 then
begin
Count := PDF.GetStringListCount(Issues);
for J := 1 to Count do
WriteLn(Files[I], ' : ', PDF.GetStringListItem(Issues, J));
PDF.ReleaseStringList(Issues);
end;
end;
end;