KSC Open API
Kaspersky Security Center API description
array RetrFiles::GetInfo ( array  aRequest)

Synchronously requests information about some retranslated files.

Parameters:
aRequestparamArray(paramParams) Array of params, each cell (paramParams) contains request-info for one updatable file:
  • KLUPD_RecentIndex ("Index"): primary index relative path in lowercase. This parameter can be one of the following values (separated by commas): "index/u1313g.xml", "index/u1901g.xml", "index/u0607g.xml", "updaters/updater.xml";
  • KLUPD_RecentCompId ("CompId"): updatable file component id in UPPERCASE, e.g. "KSC";
  • KLUPD_RecentFileName ("FileName"): file name without path in lowercase, e.g. "kscdat.zip".
Returns:
paramArray(paramArray(paramParams)) Array of found files info, correspondingly to incoming request-array, cell-by-cell. Each output cell is paramArray(paramParams), that is list of matched files data, where every file-info is params:
  • KLUPD_RecentRelativeSrvPath ("RelativeSrvPath"): file's relative path inside retranslation folder, e.g. "updates/ksc/".
If nothing is found for given in-cell, then corresponding out-cell is NULL. Null/empty in-params results in null out-array.
Note:
            Request: (ARRAY_T)
                [0]: (PARAMS_T)
                    Index == "index/u1313g.xml"
                    CompId == "KSC"
                    FileName == "kscdat.zip"
                [1]: (PARAMS_T)
                    CompId == "UPDATER"
                    FileName == "updcfg.xml"
                [2]: (PARAMS_T)
                    FileName == "there_is_no_such_file.xxx"

            Response: (ARRAY_T)
                [0]: (ARRAY_T)
                    [0]: (PARAMS_T) RelativeSrvPath == "updates/ksc/"
                [1]: (ARRAY_T)
                    [0]: (PARAMS_T) RelativeSrvPath == "updates/upd/"
                    [1]: (PARAMS_T) RelativeSrvPath == "bases/upd/"
                [2]: (ARRAY_T) is NULL