ReleaseStringList

Funciones varias

Descripción

Libera una lista de cadenas devuelta previamente por otra función de API (por ejemplo, CheckFileCompliance) Después de esta llamada, el identificador StringListID deja de ser válido y no se debe pasar a GetStringListCount ni a GetStringListItem

Sintaxis

Delphi

Function TPDFlib.ReleaseStringList(StringListID: Integer): Integer;

ActiveX

Function PDFlib::ReleaseStringList(StringListID As Long) As Long

DLL

int DLReleaseStringList(int InstanceID, int StringListID);

Parámetros

StringListID	El ID de la lista de cadenas que se va a liberar, como lo devolvió previamente una función productora

Valores devueltos

0	StringListID no es válido o no hace referencia a una lista de cadenas perteneciente a esta instancia
1	La lista se liberó correctamente

Observaciones

Las listas de cadenas pertenecen a la instancia PDFlib que las produjo. Se liberan automáticamente al destruirse la instancia, por lo que la liberación explícita normalmente es opcional. Llame a ReleaseStringList en procesos de larga ejecución que produzcan muchas listas (por ejemplo, un trabajador de CI que valida cientos de PDF en secuencia) para mantener limitado el uso de memoria

Ejemplo

// 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;

Véase también

GetStringListCount, GetStringListItem, CheckFileCompliance