<refentry id="gnome-vfs-20-gnome-vfs-directory-list-ops">
<refmeta>
<refentrytitle id="top_of_page">Listing Directory Contents</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GNOME-VFS-2.0 Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>Listing Directory Contents</refname>
<refpurpose>
Listing the contents of directories.</refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv id="synopsis">
<title id="synopsis.title">Synopsis</title>

<synopsis>



enum        <link linkend="GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</link>;
<link linkend="gboolean">gboolean</link>    (<link linkend="GnomeVFSDirectoryVisitFunc">*GnomeVFSDirectoryVisitFunc</link>)   (const <link linkend="gchar">gchar</link> *rel_path,
                                             <link linkend="GnomeVFSFileInfo">GnomeVFSFileInfo</link> *info,
                                             <link linkend="gboolean">gboolean</link> recursing_will_loop,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="gboolean">gboolean</link> *recurse);
<link linkend="GnomeVFSResult">GnomeVFSResult</link> <link linkend="gnome-vfs-directory-open">gnome_vfs_directory_open</link>     (<link linkend="GnomeVFSDirectoryHandle">GnomeVFSDirectoryHandle</link> **handle,
                                             const <link linkend="gchar">gchar</link> *text_uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> options);
<link linkend="GnomeVFSResult">GnomeVFSResult</link> <link linkend="gnome-vfs-directory-open-from-uri">gnome_vfs_directory_open_from_uri</link>
                                            (<link linkend="GnomeVFSDirectoryHandle">GnomeVFSDirectoryHandle</link> **handle,
                                             <link linkend="GnomeVFSURI">GnomeVFSURI</link> *uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> options);
<link linkend="GnomeVFSResult">GnomeVFSResult</link> <link linkend="gnome-vfs-directory-read-next">gnome_vfs_directory_read_next</link>
                                            (<link linkend="GnomeVFSDirectoryHandle">GnomeVFSDirectoryHandle</link> *handle,
                                             <link linkend="GnomeVFSFileInfo">GnomeVFSFileInfo</link> *file_info);
<link linkend="GnomeVFSResult">GnomeVFSResult</link> <link linkend="gnome-vfs-directory-close">gnome_vfs_directory_close</link>    (<link linkend="GnomeVFSDirectoryHandle">GnomeVFSDirectoryHandle</link> *handle);
<link linkend="GnomeVFSResult">GnomeVFSResult</link> <link linkend="gnome-vfs-directory-visit">gnome_vfs_directory_visit</link>    (const <link linkend="gchar">gchar</link> *text_uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> info_options,
                                             <link linkend="GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</link> visit_options,
                                             <link linkend="GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GnomeVFSResult">GnomeVFSResult</link> <link linkend="gnome-vfs-directory-visit-uri">gnome_vfs_directory_visit_uri</link>
                                            (<link linkend="GnomeVFSURI">GnomeVFSURI</link> *uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> info_options,
                                             <link linkend="GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</link> visit_options,
                                             <link linkend="GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GnomeVFSResult">GnomeVFSResult</link> <link linkend="gnome-vfs-directory-visit-files">gnome_vfs_directory_visit_files</link>
                                            (const <link linkend="gchar">gchar</link> *text_uri,
                                             <link linkend="GList">GList</link> *file_list,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> info_options,
                                             <link linkend="GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</link> visit_options,
                                             <link linkend="GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GnomeVFSResult">GnomeVFSResult</link> <link linkend="gnome-vfs-directory-visit-files-at-uri">gnome_vfs_directory_visit_files_at_uri</link>
                                            (<link linkend="GnomeVFSURI">GnomeVFSURI</link> *uri,
                                             <link linkend="GList">GList</link> *file_list,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> info_options,
                                             <link linkend="GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</link> visit_options,
                                             <link linkend="GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GnomeVFSResult">GnomeVFSResult</link> <link linkend="gnome-vfs-directory-list-load">gnome_vfs_directory_list_load</link>
                                            (<link linkend="GList">GList</link> **list,
                                             const <link linkend="gchar">gchar</link> *text_uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> options);
</synopsis>
</refsynopsisdiv>









<refsect1 id="desc">
<title id="desc.title">Description</title>
<para>

</para>
</refsect1>

<refsect1 id="details">
<title id="details.title">Details</title>
<refsect2>
<title><anchor id="GnomeVFSDirectoryVisitOptions" role="enum"/>enum GnomeVFSDirectoryVisitOptions</title>
<indexterm><primary>GnomeVFSDirectoryVisitOptions</primary></indexterm><programlisting>typedef enum {
	GNOME_VFS_DIRECTORY_VISIT_DEFAULT = 0,
	GNOME_VFS_DIRECTORY_VISIT_SAMEFS = 1 &lt;&lt; 0,
	GNOME_VFS_DIRECTORY_VISIT_LOOPCHECK = 1 &lt;&lt; 1
} GnomeVFSDirectoryVisitOptions;
</programlisting>
<para>
This options control the way in which directories are visited.</para>
<para>

</para><variablelist role="enum">
<varlistentry>
<term><literal>GNOME_VFS_DIRECTORY_VISIT_DEFAULT</literal></term>
<listitem><simpara> 
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><literal>GNOME_VFS_DIRECTORY_VISIT_SAMEFS</literal></term>
<listitem><simpara> Visit only directories on the same 
file system as the parent
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><literal>GNOME_VFS_DIRECTORY_VISIT_LOOPCHECK</literal></term>
<listitem><simpara> Loop prevention
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GnomeVFSDirectoryVisitFunc" role="function"/>GnomeVFSDirectoryVisitFunc ()</title>
<indexterm><primary>GnomeVFSDirectoryVisitFunc</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    (*GnomeVFSDirectoryVisitFunc)   (const <link linkend="gchar">gchar</link> *rel_path,
                                             <link linkend="GnomeVFSFileInfo">GnomeVFSFileInfo</link> *info,
                                             <link linkend="gboolean">gboolean</link> recursing_will_loop,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="gboolean">gboolean</link> *recurse);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>rel_path</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>info</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursing_will_loop</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recurse</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-directory-open" role="function"/>gnome_vfs_directory_open ()</title>
<indexterm><primary>gnome_vfs_directory_open</primary></indexterm><programlisting><link linkend="GnomeVFSResult">GnomeVFSResult</link> gnome_vfs_directory_open     (<link linkend="GnomeVFSDirectoryHandle">GnomeVFSDirectoryHandle</link> **handle,
                                             const <link linkend="gchar">gchar</link> *text_uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> options);</programlisting>
<para>
Open directory <parameter>text_uri</parameter> for reading.  On return, @*handle will point to
a <link linkend="GnomeVFSDirectoryHandle"><type>GnomeVFSDirectoryHandle</type></link> object which can be used to read the directory
entries one by one.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>handle</parameter>&nbsp;:</term>
<listitem><simpara> pointer to a pointer to a <link linkend="GnomeVFSDirectoryHandle"><type>GnomeVFSDirectoryHandle</type></link> object.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text_uri</parameter>&nbsp;:</term>
<listitem><simpara> string representing the uri to open.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>options</parameter>&nbsp;:</term>
<listitem><simpara> options for reading file information.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> an integer representing the result of the operation.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-directory-open-from-uri" role="function"/>gnome_vfs_directory_open_from_uri ()</title>
<indexterm><primary>gnome_vfs_directory_open_from_uri</primary></indexterm><programlisting><link linkend="GnomeVFSResult">GnomeVFSResult</link> gnome_vfs_directory_open_from_uri
                                            (<link linkend="GnomeVFSDirectoryHandle">GnomeVFSDirectoryHandle</link> **handle,
                                             <link linkend="GnomeVFSURI">GnomeVFSURI</link> *uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> options);</programlisting>
<para>
Open directory <parameter>text_uri</parameter> for reading.  On return, @*handle will point to
a <link linkend="GnomeVFSDirectoryHandle"><type>GnomeVFSDirectoryHandle</type></link> object which can be used to read the directory
entries one by one.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>handle</parameter>&nbsp;:</term>
<listitem><simpara> pointer to a pointer to a <link linkend="GnomeVFSDirectoryHandle"><type>GnomeVFSDirectoryHandle</type></link> object.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>uri</parameter>&nbsp;:</term>
<listitem><simpara> uri to open.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>options</parameter>&nbsp;:</term>
<listitem><simpara> options for reading file information.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> an integer representing the result of the operation.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-directory-read-next" role="function"/>gnome_vfs_directory_read_next ()</title>
<indexterm><primary>gnome_vfs_directory_read_next</primary></indexterm><programlisting><link linkend="GnomeVFSResult">GnomeVFSResult</link> gnome_vfs_directory_read_next
                                            (<link linkend="GnomeVFSDirectoryHandle">GnomeVFSDirectoryHandle</link> *handle,
                                             <link linkend="GnomeVFSFileInfo">GnomeVFSFileInfo</link> *file_info);</programlisting>
<para>
Read the next directory entry from <parameter>handle</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>handle</parameter>&nbsp;:</term>
<listitem><simpara> a directory handle.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>file_info</parameter>&nbsp;:</term>
<listitem><simpara> pointer to a <link linkend="GnomeVFSFileInfo"><type>GnomeVFSFileInfo</type></link> struct where the data about
the directory at <parameter>handle</parameter> will be stored.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> an integer value representing the result of the operation.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-directory-close" role="function"/>gnome_vfs_directory_close ()</title>
<indexterm><primary>gnome_vfs_directory_close</primary></indexterm><programlisting><link linkend="GnomeVFSResult">GnomeVFSResult</link> gnome_vfs_directory_close    (<link linkend="GnomeVFSDirectoryHandle">GnomeVFSDirectoryHandle</link> *handle);</programlisting>
<para>
Close <parameter>handle</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>handle</parameter>&nbsp;:</term>
<listitem><simpara> a directory handle.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> an integer representing the result of the operation.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-directory-visit" role="function"/>gnome_vfs_directory_visit ()</title>
<indexterm><primary>gnome_vfs_directory_visit</primary></indexterm><programlisting><link linkend="GnomeVFSResult">GnomeVFSResult</link> gnome_vfs_directory_visit    (const <link linkend="gchar">gchar</link> *text_uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> info_options,
                                             <link linkend="GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</link> visit_options,
                                             <link linkend="GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Visit <parameter>text_uri</parameter>, retrieving information as specified by <parameter>info_options</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>text_uri</parameter>&nbsp;:</term>
<listitem><simpara> string representation of uri to start from.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>info_options</parameter>&nbsp;:</term>
<listitem><simpara> options specifying what kind of file information must be
retrieved.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>visit_options</parameter>&nbsp;:</term>
<listitem><simpara> options specifying the type of visit.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara> callback to be called for every visited file.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara> data to be passed to <parameter>callback</parameter> at each iteration.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GnomeVFSResult"><type>GnomeVFSResult</type></link> indicating the success of the operation.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-directory-visit-uri" role="function"/>gnome_vfs_directory_visit_uri ()</title>
<indexterm><primary>gnome_vfs_directory_visit_uri</primary></indexterm><programlisting><link linkend="GnomeVFSResult">GnomeVFSResult</link> gnome_vfs_directory_visit_uri
                                            (<link linkend="GnomeVFSURI">GnomeVFSURI</link> *uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> info_options,
                                             <link linkend="GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</link> visit_options,
                                             <link linkend="GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Visit <parameter>uri</parameter>, retrieving information as specified by <parameter>info_options</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>uri</parameter>&nbsp;:</term>
<listitem><simpara> uri to start from.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>info_options</parameter>&nbsp;:</term>
<listitem><simpara> options specifying what kind of file information must be
retrieved.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>visit_options</parameter>&nbsp;:</term>
<listitem><simpara> options specifying the type of visit.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara> callback to be called for every visited file.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara> data to be passed to <parameter>callback</parameter> at each iteration.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GnomeVFSResult"><type>GnomeVFSResult</type></link> indicating whether the operation succeeded.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-directory-visit-files" role="function"/>gnome_vfs_directory_visit_files ()</title>
<indexterm><primary>gnome_vfs_directory_visit_files</primary></indexterm><programlisting><link linkend="GnomeVFSResult">GnomeVFSResult</link> gnome_vfs_directory_visit_files
                                            (const <link linkend="gchar">gchar</link> *text_uri,
                                             <link linkend="GList">GList</link> *file_list,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> info_options,
                                             <link linkend="GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</link> visit_options,
                                             <link linkend="GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Fetches information about a list of files in a base uri <parameter>uri</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>text_uri</parameter>&nbsp;:</term>
<listitem><simpara> string representing the uri of a directory to visit the files in.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>file_list</parameter>&nbsp;:</term>
<listitem><simpara> <link linkend="GList"><type>GList</type></link> of char *s of file names in <parameter>uri</parameter> to visit.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>info_options</parameter>&nbsp;:</term>
<listitem><simpara> bitmask controlling the type of information to fetch.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>visit_options</parameter>&nbsp;:</term>
<listitem><simpara> options controlling e.g. loop prevention, and filesystem checks.
Affects the way visiting is done.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara> function to call with the file info structs.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara> data to pass to <parameter>callback</parameter>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GnomeVFSResult"><type>GnomeVFSResult</type></link> indicating the success of the operation.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-directory-visit-files-at-uri" role="function"/>gnome_vfs_directory_visit_files_at_uri ()</title>
<indexterm><primary>gnome_vfs_directory_visit_files_at_uri</primary></indexterm><programlisting><link linkend="GnomeVFSResult">GnomeVFSResult</link> gnome_vfs_directory_visit_files_at_uri
                                            (<link linkend="GnomeVFSURI">GnomeVFSURI</link> *uri,
                                             <link linkend="GList">GList</link> *file_list,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> info_options,
                                             <link linkend="GnomeVFSDirectoryVisitOptions">GnomeVFSDirectoryVisitOptions</link> visit_options,
                                             <link linkend="GnomeVFSDirectoryVisitFunc">GnomeVFSDirectoryVisitFunc</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Fetches information about a list of files in a base uri <parameter>uri</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>uri</parameter>&nbsp;:</term>
<listitem><simpara> uri of a directory to visit the files in.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>file_list</parameter>&nbsp;:</term>
<listitem><simpara> <link linkend="GList"><type>GList</type></link> of char *s of file names in <parameter>uri</parameter> to visit.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>info_options</parameter>&nbsp;:</term>
<listitem><simpara> bitmask controlling the type of information to fetch.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>visit_options</parameter>&nbsp;:</term>
<listitem><simpara> options controlling e.g. loop prevention, and filesystem checks.
Affects the way visiting is done.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara> function to call with the file info structs.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara> data to pass to <parameter>callback</parameter>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GnomeVFSResult"><type>GnomeVFSResult</type></link> indicating the success of the operation.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-directory-list-load" role="function"/>gnome_vfs_directory_list_load ()</title>
<indexterm><primary>gnome_vfs_directory_list_load</primary></indexterm><programlisting><link linkend="GnomeVFSResult">GnomeVFSResult</link> gnome_vfs_directory_list_load
                                            (<link linkend="GList">GList</link> **list,
                                             const <link linkend="gchar">gchar</link> *text_uri,
                                             <link linkend="GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</link> options);</programlisting>
<para>
Load a directory from <parameter>text_uri</parameter> with the specified <parameter>options</parameter>
into a list.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
<listitem><simpara> address of a pointer to a list of <link linkend="GnomeVFSFileInfo"><type>GnomeVFSFileInfo</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text_uri</parameter>&nbsp;:</term>
<listitem><simpara> a string representing the uri of the directory.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>options</parameter>&nbsp;:</term>
<listitem><simpara> options for loading the directory.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> an integer representing the result of the operation.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>
