<trclass="memdesc:af055c05be2e7025d0931585bd6a9b755"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Enables or disables Crashpad forwarding of exceptions to the system’s crash reporter. <ahref="#af055c05be2e7025d0931585bd6a9b755">More...</a><br/></td></tr>
<trclass="memdesc:a4f8a74e178343694b264f27be26f9898"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns the global <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> structure. <br/></td></tr>
<divclass="textblock"><p>A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad crash handler. </p>
<p>It is possible for one <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> structure to appear in each loaded code module in a process, but from the perspective of the user of the client interface, there is only one global <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> structure, located in the module that contains the client interface code. </p>
</div><h2class="groupheader">Member Function Documentation</h2>
<p>Enables or disables Crashpad handler processing. </p>
<p>When handling an exception, the Crashpad handler will scan all modules in a process. The first one that has a <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> structure populated with a value other than <aclass="el"href="namespacecrashpad.html#a3b405c19a5787fabcfba96001d49f292ac69d34d47bfd5244204004878441d53f"title="The value has not explicitly been set. ">kUnset</a> for this field will dictate whether the handler is functional or not. If all modules with a <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> structure specify <aclass="el"href="namespacecrashpad.html#a3b405c19a5787fabcfba96001d49f292ac69d34d47bfd5244204004878441d53f"title="The value has not explicitly been set. ">kUnset</a>, the handler will be enabled. If disabled, the Crashpad handler will still run and receive exceptions, but will not take any action on an exception on its own behalf, except for the action necessary to determine that it has been disabled.</p>
<p>The Crashpad handler should not normally be disabled. More commonly, it is appropraite to disable crash report upload by calling <aclass="el"href="classcrashpad_1_1Settings.html#a1af15625bc137e0a67f6f9fcf016382b"title="Sets the user’s preference for submitting crash reports to a collection server. ">Settings::SetUploadsEnabled()</a>. </p>
<p>Simple annotations set on a <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> structure are interpreted by Crashpad as module-level annotations.</p>
<p>Annotations may exist in <em>simple_annotations</em> at the time that this method is called, or they may be added, removed, or modified in <em>simple_annotations</em> after this method is called.</p>
<dlclass="params"><dt>Parameters</dt><dd>
<tableclass="params">
<tr><tdclass="paramdir">[in]</td><tdclass="paramname">simple_annotations</td><td>A dictionary that maps string keys to string values. The <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> object does not take ownership of the SimpleStringDictionary object. It is the caller’s responsibility to ensure that this pointer remains valid while it is in effect for a <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> object. </td></tr>
<p>Enables or disables Crashpad forwarding of exceptions to the system’s crash reporter. </p>
<p>When handling an exception, the Crashpad handler will scan all modules in a process. The first one that has a <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> structure populated with a value other than <aclass="el"href="namespacecrashpad.html#a3b405c19a5787fabcfba96001d49f292ac69d34d47bfd5244204004878441d53f"title="The value has not explicitly been set. ">kUnset</a> for this field will dictate whether the exception is forwarded to the system’s crash reporter. If all modules with a <aclass="el"href="structcrashpad_1_1CrashpadInfo.html"title="A structure that can be used by a Crashpad-enabled program to provide information to the Crashpad cra...">CrashpadInfo</a> structure specify <aclass="el"href="namespacecrashpad.html#a3b405c19a5787fabcfba96001d49f292ac69d34d47bfd5244204004878441d53f"title="The value has not explicitly been set. ">kUnset</a>, forwarding will be enabled. Unless disabled, forwarding may still occur if the Crashpad handler is disabled by SetCrashpadHandlerState(). Even when forwarding is enabled, the Crashpad handler may choose not to forward all exceptions to the system’s crash reporter in cases where it has reason to believe that the system’s crash reporter would not normally have handled the exception in Crashpad’s absence. </p>
</div>
</div>
<hr/>The documentation for this struct was generated from the following files:<ul>
<li>client/crashpad_info.h</li>
<li>client/crashpad_info.cc</li>
</ul>
</div><!-- contents -->
<!-- start footer part -->
<hrclass="footer"/><addressclass="footer"><small>
Generated by  <ahref="http://www.doxygen.org/index.html">
