discovery.listDirectory

discovery.listDirectory(target, path[, win64_redirect=true|false])

Retrieves the directory listing of the directory specified by the path on the specified target.

The function takes the following parameters:

• target, where target is:
  • a node used to identify the discovery target, either a directly discovered data node, or a Host node. Or,
  • a data source against which the request is performed. See also, discovery-dataSource.
• path – the path to the directory on which to return information. You cannot use wildcards in the path. 
• win64_redirect is an optional flag which enables you to specify whether the search for the file should take place in the 32 bit directory if not found in the 64 bit directory. TRUE means search the 32 bit directory, FALSE means do not search the 32 bit directory if the file is not found in the 64 bit directory. The default is TRUE.

Returns a list of Discovered Directory Entry nodes.

64 bit Windows hosts have the following system directories for holding executables, DLLs, and so forth:

• %windir%\system32 — 64 bit executables and DLLs
• %windir%\SysWOW64 — 32 bit executables and DLLs

Paths that do not start with %windir%\system32 or %systemroot%\system32 are never checked for redirection.

On non-Windows and 32 bit Windows systems win64_redirect has no effect.

If the call fails, it returns none and records the failure reason in the Directory Listing node.

Retrieves the specified file.

Restrictions

1. On Windows systems, owner and group information is not recovered.
2. Group names which include spaces are not supported.
3. Config.sys is not listed as a system file.
4. Directory Listing nodes are not created for empty Windows directories.