<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="PkResults">
<refmeta>
<refentrytitle role="top_of_page" id="PkResults.top_of_page">PkResults</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>PACKAGEKIT Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>PkResults</refname>
<refpurpose>Transaction results</refpurpose>
</refnamediv>

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

<synopsis>
#define             <link linkend="PK-RESULTS-ERROR--CAPS">PK_RESULTS_ERROR</link>
#define             <link linkend="PK-RESULTS-TYPE-ERROR--CAPS">PK_RESULTS_TYPE_ERROR</link>
                    <link linkend="PkResultsPrivate">PkResultsPrivate</link>;
                    <link linkend="PkResults-struct">PkResults</link>;
<link linkend="GQuark">GQuark</link>              <link linkend="pk-results-error-quark">pk_results_error_quark</link>              (void);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-results-new">pk_results_new</link>                      (void);
<link linkend="void">void</link>                <link linkend="pk-results-test">pk_results_test</link>                     (<link linkend="gpointer">gpointer</link> user_data);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-set-exit-code">pk_results_set_exit_code</link>            (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkExitEnum">PkExitEnum</link> exit_enum);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-set-error-code">pk_results_set_error_code</link>           (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkError">PkError</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-package">pk_results_add_package</link>              (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkPackage">PkPackage</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-details">pk_results_add_details</link>              (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkDetails">PkDetails</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-update-detail">pk_results_add_update_detail</link>        (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkUpdateDetail">PkUpdateDetail</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-category">pk_results_add_category</link>             (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkCategory">PkCategory</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-distro-upgrade">pk_results_add_distro_upgrade</link>       (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkDistroUpgrade">PkDistroUpgrade</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-require-restart">pk_results_add_require_restart</link>      (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkRequireRestart">PkRequireRestart</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-transaction">pk_results_add_transaction</link>          (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkTransactionPast">PkTransactionPast</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-files">pk_results_add_files</link>                (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkFiles">PkFiles</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-repo-signature-required">pk_results_add_repo_signature_required</link>
                                                        (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkRepoSignatureRequired">PkRepoSignatureRequired</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-eula-required">pk_results_add_eula_required</link>        (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkEulaRequired">PkEulaRequired</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-media-change-required">pk_results_add_media_change_required</link>
                                                        (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkMediaChangeRequired">PkMediaChangeRequired</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-repo-detail">pk_results_add_repo_detail</link>          (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkRepoDetail">PkRepoDetail</link> *item);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-results-add-message">pk_results_add_message</link>              (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkMessage">PkMessage</link> *item);
<link linkend="PkExitEnum">PkExitEnum</link>          <link linkend="pk-results-get-exit-code">pk_results_get_exit_code</link>            (<link linkend="PkResults">PkResults</link> *results);
<link linkend="PkPackageSack">PkPackageSack</link> *     <link linkend="pk-results-get-package-sack">pk_results_get_package_sack</link>         (<link linkend="PkResults">PkResults</link> *results);
<link linkend="PkError">PkError</link> *           <link linkend="pk-results-get-error-code">pk_results_get_error_code</link>           (<link linkend="PkResults">PkResults</link> *results);
<link linkend="PkRestartEnum">PkRestartEnum</link>       <link linkend="pk-results-get-require-restart-worst">pk_results_get_require_restart_worst</link>
                                                        (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-package-array">pk_results_get_package_array</link>        (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-details-array">pk_results_get_details_array</link>        (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-update-detail-array">pk_results_get_update_detail_array</link>  (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-category-array">pk_results_get_category_array</link>       (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-distro-upgrade-array">pk_results_get_distro_upgrade_array</link> (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-require-restart-array">pk_results_get_require_restart_array</link>
                                                        (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-transaction-array">pk_results_get_transaction_array</link>    (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-files-array">pk_results_get_files_array</link>          (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-repo-signature-required-array">pk_results_get_repo_signature_required_array</link>
                                                        (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-eula-required-array">pk_results_get_eula_required_array</link>  (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-media-change-required-array">pk_results_get_media_change_required_array</link>
                                                        (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-repo-detail-array">pk_results_get_repo_detail_array</link>    (<link linkend="PkResults">PkResults</link> *results);
<link linkend="GPtrArray">GPtrArray</link> *         <link linkend="pk-results-get-message-array">pk_results_get_message_array</link>        (<link linkend="PkResults">PkResults</link> *results);
</synopsis>
</refsynopsisdiv>

<refsect1 id="PkResults.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----PkResults
</synopsis>
</refsect1>





<refsect1 id="PkResults.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="PkResults--inputs">inputs</link>&quot;                   <link linkend="guint">guint</link>                 : Read / Write
  &quot;<link linkend="PkResults--progress">progress</link>&quot;                 <link linkend="PkProgress">PkProgress</link>*           : Read / Write
  &quot;<link linkend="PkResults--role">role</link>&quot;                     <link linkend="guint">guint</link>                 : Read / Write
</synopsis>
</refsect1>



<refsect1 id="PkResults.description" role="desc">
<title role="desc.title">Description</title>
<para>
This GObject allows a client program to query the results sent from
PackageKit. This will include <link linkend="Package"><function>Package()</function></link>, <link linkend="ErrorCode"><function>ErrorCode()</function></link> and all the other types
of objects. Everything is refcounted, so ensure you unref when done with the
data.</para>
<para>
</para>
</refsect1>

<refsect1 id="PkResults.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="PK-RESULTS-ERROR--CAPS" role="macro">
<title>PK_RESULTS_ERROR</title>
<indexterm zone="PK-RESULTS-ERROR--CAPS"><primary sortas="PK_RESULTS_ERROR">PK_RESULTS_ERROR</primary></indexterm><programlisting>#define PK_RESULTS_ERROR	(pk_results_error_quark ())
</programlisting>
<para>
</para></refsect2>
<refsect2 id="PK-RESULTS-TYPE-ERROR--CAPS" role="macro">
<title>PK_RESULTS_TYPE_ERROR</title>
<indexterm zone="PK-RESULTS-TYPE-ERROR--CAPS"><primary sortas="PK_RESULTS_TYPE_ERROR">PK_RESULTS_TYPE_ERROR</primary></indexterm><programlisting>#define PK_RESULTS_TYPE_ERROR	(pk_results_error_get_type ())
</programlisting>
<para>
</para></refsect2>
<refsect2 id="PkResultsPrivate" role="struct">
<title>PkResultsPrivate</title>
<indexterm zone="PkResultsPrivate"><primary sortas="PkResultsPrivate">PkResultsPrivate</primary></indexterm><programlisting>typedef struct _PkResultsPrivate PkResultsPrivate;</programlisting>
<para>
Private <link linkend="PkResults"><type>PkResults</type></link> data</para>
<para>
</para></refsect2>
<refsect2 id="PkResults-struct" role="struct">
<title>PkResults</title>
<indexterm zone="PkResults-struct"><primary sortas="PkResults">PkResults</primary></indexterm><programlisting>typedef struct _PkResults PkResults;</programlisting>
<para>
</para></refsect2>
<refsect2 id="pk-results-error-quark" role="function">
<title>pk_results_error_quark ()</title>
<indexterm zone="pk-results-error-quark"><primary sortas="pk_results_error_quark">pk_results_error_quark</primary></indexterm><programlisting><link linkend="GQuark">GQuark</link>              pk_results_error_quark              (void);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-new" role="function">
<title>pk_results_new ()</title>
<indexterm zone="pk-results-new"><primary sortas="pk_results_new">pk_results_new</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_results_new                      (void);</programlisting>
<para>
</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new PkResults object.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-test" role="function">
<title>pk_results_test ()</title>
<indexterm zone="pk-results-test"><primary sortas="pk_results_test">pk_results_test</primary></indexterm><programlisting><link linkend="void">void</link>                pk_results_test                     (<link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-set-exit-code" role="function">
<title>pk_results_set_exit_code ()</title>
<indexterm zone="pk-results-set-exit-code"><primary sortas="pk_results_set_exit_code">pk_results_set_exit_code</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_set_exit_code            (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkExitEnum">PkExitEnum</link> exit_enum);</programlisting>
<para>
Sets the results object to have the given exit code.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>exit_enum</parameter>&#160;:</term>
<listitem><simpara> the exit code
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-set-error-code" role="function">
<title>pk_results_set_error_code ()</title>
<indexterm zone="pk-results-set-error-code"><primary sortas="pk_results_set_error_code">pk_results_set_error_code</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_set_error_code           (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkError">PkError</link> *item);</programlisting>
<para>
Adds some error details to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-package" role="function">
<title>pk_results_add_package ()</title>
<indexterm zone="pk-results-add-package"><primary sortas="pk_results_add_package">pk_results_add_package</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_package              (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkPackage">PkPackage</link> *item);</programlisting>
<para>
Adds a package to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-details" role="function">
<title>pk_results_add_details ()</title>
<indexterm zone="pk-results-add-details"><primary sortas="pk_results_add_details">pk_results_add_details</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_details              (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkDetails">PkDetails</link> *item);</programlisting>
<para>
Adds some package details to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-update-detail" role="function">
<title>pk_results_add_update_detail ()</title>
<indexterm zone="pk-results-add-update-detail"><primary sortas="pk_results_add_update_detail">pk_results_add_update_detail</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_update_detail        (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkUpdateDetail">PkUpdateDetail</link> *item);</programlisting>
<para>
Adds some update details to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-category" role="function">
<title>pk_results_add_category ()</title>
<indexterm zone="pk-results-add-category"><primary sortas="pk_results_add_category">pk_results_add_category</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_category             (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkCategory">PkCategory</link> *item);</programlisting>
<para>
Adds a category item to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-distro-upgrade" role="function">
<title>pk_results_add_distro_upgrade ()</title>
<indexterm zone="pk-results-add-distro-upgrade"><primary sortas="pk_results_add_distro_upgrade">pk_results_add_distro_upgrade</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_distro_upgrade       (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkDistroUpgrade">PkDistroUpgrade</link> *item);</programlisting>
<para>
Adds a distribution upgrade item to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-require-restart" role="function">
<title>pk_results_add_require_restart ()</title>
<indexterm zone="pk-results-add-require-restart"><primary sortas="pk_results_add_require_restart">pk_results_add_require_restart</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_require_restart      (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkRequireRestart">PkRequireRestart</link> *item);</programlisting>
<para>
Adds a require restart item to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-transaction" role="function">
<title>pk_results_add_transaction ()</title>
<indexterm zone="pk-results-add-transaction"><primary sortas="pk_results_add_transaction">pk_results_add_transaction</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_transaction          (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkTransactionPast">PkTransactionPast</link> *item);</programlisting>
<para>
Adds a transaction item to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-files" role="function">
<title>pk_results_add_files ()</title>
<indexterm zone="pk-results-add-files"><primary sortas="pk_results_add_files">pk_results_add_files</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_files                (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkFiles">PkFiles</link> *item);</programlisting>
<para>
Adds some files details to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-repo-signature-required" role="function">
<title>pk_results_add_repo_signature_required ()</title>
<indexterm zone="pk-results-add-repo-signature-required"><primary sortas="pk_results_add_repo_signature_required">pk_results_add_repo_signature_required</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_repo_signature_required
                                                        (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkRepoSignatureRequired">PkRepoSignatureRequired</link> *item);</programlisting>
<para>
Adds some repository signature details to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-eula-required" role="function">
<title>pk_results_add_eula_required ()</title>
<indexterm zone="pk-results-add-eula-required"><primary sortas="pk_results_add_eula_required">pk_results_add_eula_required</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_eula_required        (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkEulaRequired">PkEulaRequired</link> *item);</programlisting>
<para>
Adds some EULA details to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-media-change-required" role="function">
<title>pk_results_add_media_change_required ()</title>
<indexterm zone="pk-results-add-media-change-required"><primary sortas="pk_results_add_media_change_required">pk_results_add_media_change_required</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_media_change_required
                                                        (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkMediaChangeRequired">PkMediaChangeRequired</link> *item);</programlisting>
<para>
Adds some media change details to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-repo-detail" role="function">
<title>pk_results_add_repo_detail ()</title>
<indexterm zone="pk-results-add-repo-detail"><primary sortas="pk_results_add_repo_detail">pk_results_add_repo_detail</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_repo_detail          (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkRepoDetail">PkRepoDetail</link> *item);</programlisting>
<para>
Adds some repository details to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-add-message" role="function">
<title>pk_results_add_message ()</title>
<indexterm zone="pk-results-add-message"><primary sortas="pk_results_add_message">pk_results_add_message</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_results_add_message              (<link linkend="PkResults">PkResults</link> *results,
                                                         <link linkend="PkMessage">PkMessage</link> *item);</programlisting>
<para>
Adds some message details to the results set.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> the object to add to the array
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the value was set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-exit-code" role="function">
<title>pk_results_get_exit_code ()</title>
<indexterm zone="pk-results-get-exit-code"><primary sortas="pk_results_get_exit_code">pk_results_get_exit_code</primary></indexterm><programlisting><link linkend="PkExitEnum">PkExitEnum</link>          pk_results_get_exit_code            (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the exit enum. You probably don't want to be using this function, and
instead using the much more useful <link linkend="pk-results-get-error-code"><function>pk_results_get_error_code()</function></link> function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The <link linkend="PkExitEnum"><type>PkExitEnum</type></link> or <link linkend="PK-EXIT-ENUM-UNKNOWN--CAPS"><literal>PK_EXIT_ENUM_UNKNOWN</literal></link> for error or if it was not set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-package-sack" role="function">
<title>pk_results_get_package_sack ()</title>
<indexterm zone="pk-results-get-package-sack"><primary sortas="pk_results_get_package_sack">pk_results_get_package_sack</primary></indexterm><programlisting><link linkend="PkPackageSack">PkPackageSack</link> *     pk_results_get_package_sack         (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets a package sack from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="PkPackageSack"><type>PkPackageSack</type></link> of data.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-error-code" role="function">
<title>pk_results_get_error_code ()</title>
<indexterm zone="pk-results-get-error-code"><primary sortas="pk_results_get_error_code">pk_results_get_error_code</primary></indexterm><programlisting><link linkend="PkError">PkError</link> *           pk_results_get_error_code           (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the last error code from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="PkError"><type>PkError</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>, free with <link linkend="g-object-unref"><function>g_object_unref()</function></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-require-restart-worst" role="function">
<title>pk_results_get_require_restart_worst ()</title>
<indexterm zone="pk-results-get-require-restart-worst"><primary sortas="pk_results_get_require_restart_worst">pk_results_get_require_restart_worst</primary></indexterm><programlisting><link linkend="PkRestartEnum">PkRestartEnum</link>       pk_results_get_require_restart_worst
                                                        (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
This method returns the 'worst' restart of all the transactions.
It is needed as multiple sub-transactions may emit require-restart with
different values, and we always want to get the most invasive of all.
</para>
<para>
For instance, if a transaction emits RequireRestart(system) and then
RequireRestart(session) then pk_client_get_require_restart will return
system as a session restart is implied with a system restart.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkRestartEnum"><type>PkRestartEnum</type></link> value, e.g. PK_RESTART_ENUM_SYSTEM
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-package-array" role="function">
<title>pk_results_get_package_array ()</title>
<indexterm zone="pk-results-get-package-array"><primary sortas="pk_results_get_package_array">pk_results_get_package_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_package_array        (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the packages from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkDetails"><type>PkDetails</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-details-array" role="function">
<title>pk_results_get_details_array ()</title>
<indexterm zone="pk-results-get-details-array"><primary sortas="pk_results_get_details_array">pk_results_get_details_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_details_array        (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the package details from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkPackage"><type>PkPackage</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-update-detail-array" role="function">
<title>pk_results_get_update_detail_array ()</title>
<indexterm zone="pk-results-get-update-detail-array"><primary sortas="pk_results_get_update_detail_array">pk_results_get_update_detail_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_update_detail_array  (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the update details from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkUpdateDetail"><type>PkUpdateDetail</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-category-array" role="function">
<title>pk_results_get_category_array ()</title>
<indexterm zone="pk-results-get-category-array"><primary sortas="pk_results_get_category_array">pk_results_get_category_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_category_array       (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the categories from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkCategory"><type>PkCategory</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-distro-upgrade-array" role="function">
<title>pk_results_get_distro_upgrade_array ()</title>
<indexterm zone="pk-results-get-distro-upgrade-array"><primary sortas="pk_results_get_distro_upgrade_array">pk_results_get_distro_upgrade_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_distro_upgrade_array (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the distribution upgrades from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkDistroUpgrade"><type>PkDistroUpgrade</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-require-restart-array" role="function">
<title>pk_results_get_require_restart_array ()</title>
<indexterm zone="pk-results-get-require-restart-array"><primary sortas="pk_results_get_require_restart_array">pk_results_get_require_restart_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_require_restart_array
                                                        (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the require restarts from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkRequireRestart"><type>PkRequireRestart</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-transaction-array" role="function">
<title>pk_results_get_transaction_array ()</title>
<indexterm zone="pk-results-get-transaction-array"><primary sortas="pk_results_get_transaction_array">pk_results_get_transaction_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_transaction_array    (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the transactions from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkTransactionPast"><type>PkTransactionPast</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-files-array" role="function">
<title>pk_results_get_files_array ()</title>
<indexterm zone="pk-results-get-files-array"><primary sortas="pk_results_get_files_array">pk_results_get_files_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_files_array          (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the files from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkFiles"><type>PkFiles</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-repo-signature-required-array" role="function">
<title>pk_results_get_repo_signature_required_array ()</title>
<indexterm zone="pk-results-get-repo-signature-required-array"><primary sortas="pk_results_get_repo_signature_required_array">pk_results_get_repo_signature_required_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_repo_signature_required_array
                                                        (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the repository signatures required from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkRepoSignatureRequired"><type>PkRepoSignatureRequired</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-eula-required-array" role="function">
<title>pk_results_get_eula_required_array ()</title>
<indexterm zone="pk-results-get-eula-required-array"><primary sortas="pk_results_get_eula_required_array">pk_results_get_eula_required_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_eula_required_array  (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the eulas required from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkEulaRequired"><type>PkEulaRequired</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-media-change-required-array" role="function">
<title>pk_results_get_media_change_required_array ()</title>
<indexterm zone="pk-results-get-media-change-required-array"><primary sortas="pk_results_get_media_change_required_array">pk_results_get_media_change_required_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_media_change_required_array
                                                        (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the media changes required from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkMediaChangeRequired"><type>PkMediaChangeRequired</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-repo-detail-array" role="function">
<title>pk_results_get_repo_detail_array ()</title>
<indexterm zone="pk-results-get-repo-detail-array"><primary sortas="pk_results_get_repo_detail_array">pk_results_get_repo_detail_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_repo_detail_array    (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the repository details from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkRepoDetail"><type>PkRepoDetail</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-results-get-message-array" role="function">
<title>pk_results_get_message_array ()</title>
<indexterm zone="pk-results-get-message-array"><primary sortas="pk_results_get_message_array">pk_results_get_message_array</primary></indexterm><programlisting><link linkend="GPtrArray">GPtrArray</link> *         pk_results_get_message_array        (<link linkend="PkResults">PkResults</link> *results);</programlisting>
<para>
Gets the messages from the transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>results</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkResults"><type>PkResults</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GPtrArray"><type>GPtrArray</type></link> array of <link linkend="PkMessage"><type>PkMessage</type></link>'s, free with <link linkend="g-ptr-array-unref"><function>g_ptr_array_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="PkResults.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="PkResults--inputs" role="property"><title>The <literal>&quot;inputs&quot;</literal> property</title>
<indexterm zone="PkResults--inputs"><primary sortas="PkResults:inputs">PkResults:inputs</primary></indexterm><programlisting>  &quot;inputs&quot;                   <link linkend="guint">guint</link>                 : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="PkResults--progress" role="property"><title>The <literal>&quot;progress&quot;</literal> property</title>
<indexterm zone="PkResults--progress"><primary sortas="PkResults:progress">PkResults:progress</primary></indexterm><programlisting>  &quot;progress&quot;                 <link linkend="PkProgress">PkProgress</link>*           : Read / Write</programlisting>
<para>
</para>
<para>
</para></refsect2>
<refsect2 id="PkResults--role" role="property"><title>The <literal>&quot;role&quot;</literal> property</title>
<indexterm zone="PkResults--role"><primary sortas="PkResults:role">PkResults:role</primary></indexterm><programlisting>  &quot;role&quot;                     <link linkend="guint">guint</link>                 : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Allowed values: &lt;= 35</para>
<para>Default value: 0</para>
</refsect2>
</refsect1>




</refentry>
