ReleaseStringList

杂项函数

描述

释放由其他 API 函数（例如 CheckFileCompliance）先前返回的字符串列表。调用后，StringListID 句柄不再有效，且不得传递给 GetStringListCount 或 GetStringListItem

语法

Delphi

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

ActiveX

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

DLL

int DLReleaseStringList(int InstanceID, int StringListID);

参数

StringListID	要释放的字符串列表 ID，与产生者函数先前返回的值一致

返回值

0	StringListID 无效，或未引用此实例拥有的字符串列表
1	列表已成功释放

备注

字符串列表归创建它们的 PDFlib 实例所有。实例销毁时会自动释放这些列表，因此通常无需显式释放。对于会生成大量列表的长时间运行进程（例如连续验证数百个 PDF 的 CI 工作程序），请调用 ReleaseStringList 以限制内存使用量

示例

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

另请参阅

GetStringListCount、GetStringListItem、CheckFileCompliance