Debian Codegraph @

docs/deploy/mono-api-domains.html

raw
1 <?xml version="1.0" encoding="us-ascii"?>
2 <html xmlns="http://www.w3.org/1999/xhtml">
3 <head>
4 <title>mono-api-domains.html</title>
5 <style type="text/css">
6 .mapi-docs {
7 line-height: 1.5;
8 padding-left: 2em;
9 padding-right: 2em;
10 }
11 .mapi-docs p {
12 max-width: 60em;
13 }
14 .mapi-docs .mapi-body {
15 max-width: 60em;
16 }
17 .mapi-docs code {
18 border: 1px solid rgba(214,214,214,1);
19 background-color: rgba(249,249,249,1);
20 padding: 0.1em 0.5em;
21 }
22 .mapi-description code {
23 font-family: "Consolas", "Courier", monospace;
24 border: 1px solid rgba(214,214,214,1);
25 background-color: rgba(249,249,249,1);
26 padding: 0.1em 0.2em;
27 }
28
29 .mapi-header {
30 padding: 0 0 5pt 5pt;
31 margin: 10pt;
32 white-space: pre;
33 font-family: monospace;
34 border: 1px solid rgba(233,233,233,1);
35 background-color: rgba(249,249,249,1);
36 }
37
38 .mapi-code {
39 padding: 5pt 5pt;
40 margin: 10pt;
41 white-space: pre;
42 font-family: monospace;
43 border: 1px solid rgba(233,233,233,1);
44 background-color: rgba(249,249,249,1);
45 }
46
47 .mapi-code:first-line {
48 line-height: 0px;
49 }
50
51 .mapi-codeblock {
52 display: block;
53 padding: 5pt 5pt;
54 margin: 10pt;
55 white-space: pre;
56 font-family: monospace;
57 border: 1px solid rgba(233,233,233,1);
58 background-color: rgba(249,249,249,1);
59 }
60
61 .mapi-entry code {
62 border: none;
63 background-color: transparent;
64 }
65
66 .mapi-parameters {
67 border-collapse: collapse;
68 border-spacing: 0;
69 empty-cells: hide;
70 border: 0;
71 margin: 5px 0 26px;
72 }
73
74 .mapi-parameters td {
75 border: 1px solid rgba(214,214,214,1);
76 border-left-style: none;
77 padding: 5px 25px 5px 10px;
78 }
79
80 .mapi-parameters tr>td:last-child {
81 border-right: 0;
82 }
83
84 .mapi-parameters td:first-of-type {
85 text-align: right;
86 padding: 7px;
87 vertical-align: top;
88 word-break: normal;
89 width: 40px;
90 }
91
92 .mapi-parameters tr:last-child>td {
93 border-bottom: 0;
94 }
95
96 .mapi-parameters tr:first-child>td {
97 border-top: 0;
98 }
99
100 .mapi-parameters tr td:first-of-type {
101 text-align: right;
102 padding: 7px;
103 vertical-align: top;
104 word-break: normal;
105 width: 40px;
106 }
107
108 .mapi {
109 left: -25px;
110 margin: 0;
111 padding: 13px 25px 0;
112 position: relative;
113 width: 100%;
114 }
115
116 .mapi-description {
117 background: rgba(249,249,249,1);
118 border-bottom: 1px solid rgba(233,233,233,1);
119 left: -25px;
120 margin: 0;
121 padding: 13px 25px 0;
122 position: relative;
123 width: 100%;
124 }
125
126 .mapi-entry {
127 background: transparent;
128 }
129
130 .mapi-docs {
131 }
132
133 .mapi-prototype {
134 border-left: 5px solid rgba(205,233,244,1);
135 padding: .5em;
136 margin-top: 5pt;
137 margin-bottom: 5pt;
138 font-family: "Consolas", "Courier", monospace;
139 display: block;
140 overflow: auto;
141 background-color: #f9f9f9;
142 }
143
144 .mapi-declaration {
145 margin-top: 21px;
146 }
147
148 .mapi-section {
149 font-size: smaller;
150 font-weight: bold;
151 margin-top: 21px;
152 line-height: 1.5;
153 }
154
155 .mapi-strike {
156 text-decoration: line-through;
157 }
158
159 .mapi-deprecated {
160 color: red;
161 }
162
163 .mapi-ptr-container {
164 background: white;
165 border-bottom: 1px solid rgba(233,233,233,1);
166 left: -25px;
167 padding-left: 25px;
168 padding-right: 25px;
169 padding-bottom: 13px;
170 position: relative;
171 width: 100%;
172 }
173
174 .mapi-ptr {
175 background: rgba(249,249,249,1);
176 border-left: 1px solid rgba(233,233,233,1);
177 border-top: 1px solid rgba(233,233,233,1);
178 height: 12px;
179 left: 37px;
180 top: -7px;
181 -webkit-transform: rotate(45deg);
182 -moz-transform: rotate(45deg);
183 -o-transform: rotate(45deg);
184 transform: rotate(45deg);
185 position: absolute;
186 width: 12px;
187 }
188
189 .mapi-height-container {
190 left: -25px;
191 padding: 0 25px;
192 position: relative;
193 width: 100%;
194 }
195
196 </style>
197 </head>
198 <body>
199 <div class="mapi-docs">
200 <h2>Application Domains</h2>
201
202 <h3>Synopsis</h3>
203
204 <div class="mapi-header">
205 #include &lt;metadata/appdomain.h&gt;
206
207 /* Managed AppDomain */
208 typedef struct _MonoAppDomain MonoAppDomain;
209
210 /* Unmanaged representation */
211 typedef struct _MonoDomain MonoDomain;
212
213 /* Represents System.Runtime.Remoting.Contexts.Context */
214 typedef struct _MonoAppContext MonoAppContext
215
216 </div>
217
218 <p />Application domains are used to isolate multiple
219 applications on a single Mono virtual machine. They are
220 conceptually similiar to processes, the difference is that
221 processes are managed by the operating system, while
222 application domains are managed by the Mono virtual machine.
223
224 <p />For more information on applications domains see the <a href="http://www.gotdotnet.com/team/clr/AppdomainFAQ.aspx">AppDomain FAQ</a>.
225
226 <p />The <tt>MonoDomain</tt> is the unmanaged representation of
227 the <a href="http://www.mono-project.com/monodoc/T:System.AppDomain">System.AppDomain</a>
228 managed type, while the <tt>MonoAppDomain</tt> type represents
229 the managed version (<tt>MonoAppDomain</tt> has a pointer to
230 a <tt>MonoDomain</tt>).
231
232 <a name="api:mono_domain_assembly_open"></a>
233 <div class="mapi">
234 <div class="mapi-entry "><code>mono_domain_assembly_open</code></div>
235 <div class="mapi-height-container">
236 <div class="mapi-ptr-container"></div>
237 <div class="mapi-description">
238 <div class="mapi-ptr"></div>
239
240 <div class="mapi-declaration mapi-section">Syntax</div>
241 <div class="mapi-prototype">MonoAssembly*
242 mono_domain_assembly_open (MonoDomain *domain, const char *name)
243
244 </div>
245 <p />
246 <div class="mapi-section">Parameters</div>
247 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> the application domain</td></tr><tr><td><i>name</i></td><td> file name of the assembly</td></tr></tbody></table> </div><!--mapi-description -->
248 </div><!--height container -->
249 </div> <!-- class=mapi -->
250
251 <a name="api:mono_domain_create"></a>
252 <div class="mapi">
253 <div class="mapi-entry "><code>mono_domain_create</code></div>
254 <div class="mapi-height-container">
255 <div class="mapi-ptr-container"></div>
256 <div class="mapi-description">
257 <div class="mapi-ptr"></div>
258
259 <div class="mapi-declaration mapi-section">Syntax</div>
260 <div class="mapi-prototype">MonoDomain*
261 mono_domain_create (void)
262
263 </div>
264 <p />
265 <div class="mapi-section">Return value</div>
266 <div> New initialized <code>MonoDomain</code>, with no configuration or assemblies
267
268 loaded into it.</div>
269 <div class="mapi-section">Description</div>
270 <div>
271 <p />
272 Creates a new application domain, the unmanaged representation
273 of the actual domain.
274 <p />
275 Application domains provide an isolation facilty for assemblies. You
276 can load assemblies and execute code in them that will not be visible
277 to other application domains. This is a runtime-based virtualization
278 technology.
279 <p />
280 It is possible to unload domains, which unloads the assemblies and
281 data that was allocated in that domain.
282 <p />
283 When a domain is created a mempool is allocated for domain-specific
284 structures, along a dedicated code manager to hold code that is
285 associated with the domain.
286 <p /></div>
287 </div><!--mapi-description -->
288 </div><!--height container -->
289 </div> <!-- class=mapi -->
290
291 <a name="api:mono_domain_create_appdomain"></a>
292 <div class="mapi">
293 <div class="mapi-entry "><code>mono_domain_create_appdomain</code></div>
294 <div class="mapi-height-container">
295 <div class="mapi-ptr-container"></div>
296 <div class="mapi-description">
297 <div class="mapi-ptr"></div>
298
299 <div class="mapi-declaration mapi-section">Syntax</div>
300 <div class="mapi-prototype">MonoDomain*
301 mono_domain_create_appdomain (char *friendly_name, char *configuration_file)
302
303 </div>
304 <p />
305 <div class="mapi-section">Parameters</div>
306 <table class="mapi-parameters"><tbody><tr><td><i>friendly_name</i></td><td> The friendly name of the appdomain to create</td></tr><tr><td><i>configuration_file</i></td><td> The configuration file to initialize the appdomain with</td></tr></tbody></table> <div class="mapi-section">Return value</div>
307 <div> a <code>MonoDomain</code> initialized with the appdomain
308 </div>
309 </div><!--mapi-description -->
310 </div><!--height container -->
311 </div> <!-- class=mapi -->
312
313 <a name="api:mono_domain_finalize"></a>
314 <div class="mapi">
315 <div class="mapi-entry "><code>mono_domain_finalize</code></div>
316 <div class="mapi-height-container">
317 <div class="mapi-ptr-container"></div>
318 <div class="mapi-description">
319 <div class="mapi-ptr"></div>
320
321 <div class="mapi-declaration mapi-section">Syntax</div>
322 <div class="mapi-prototype">gboolean
323 mono_domain_finalize (MonoDomain *domain, guint32 timeout)
324
325 </div>
326 <p />
327 <div class="mapi-section">Parameters</div>
328 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> the domain to finalize</td></tr><tr><td><i>timeout</i></td><td> msecs to wait for the finalization to complete, <code>-1</code> to wait indefinitely</td></tr></tbody></table> <div class="mapi-section">Return value</div>
329 <div> <code>TRUE</code> if succeeded, <code>FALSE</code> if there was a timeout
330 </div>
331 <div class="mapi-section">Description</div>
332 <div>
333 <p />
334 Request finalization of all finalizable objects inside <i>domain</i>. Wait
335 <i>timeout</i> msecs for the finalization to complete.
336 <p /></div>
337 </div><!--mapi-description -->
338 </div><!--height container -->
339 </div> <!-- class=mapi -->
340
341 <a name="api:mono_domain_foreach"></a>
342 <div class="mapi">
343 <div class="mapi-entry "><code>mono_domain_foreach</code></div>
344 <div class="mapi-height-container">
345 <div class="mapi-ptr-container"></div>
346 <div class="mapi-description">
347 <div class="mapi-ptr"></div>
348
349 <div class="mapi-declaration mapi-section">Syntax</div>
350 <div class="mapi-prototype">void
351 mono_domain_foreach (MonoDomainFunc func, gpointer user_data)
352
353 </div>
354 <p />
355 <div class="mapi-section">Parameters</div>
356 <table class="mapi-parameters"><tbody><tr><td><i>func</i></td><td> function to invoke with the domain data</td></tr><tr><td><i>user_data</i></td><td> user-defined pointer that is passed to the supplied <i>func</i> fo reach domain</td></tr></tbody></table> <div class="mapi-section">Description</div>
357 <div>
358 <p />
359 Use this method to safely iterate over all the loaded application
360 domains in the current runtime. The provided <i>func</i> is invoked with a
361 pointer to the <code>MonoDomain</code> and is given the value of the <i>user_data</i>
362 parameter which can be used to pass state to your called routine.</div>
363 </div><!--mapi-description -->
364 </div><!--height container -->
365 </div> <!-- class=mapi -->
366
367 <a name="api:mono_domain_free"></a>
368 <div class="mapi">
369 <div class="mapi-entry "><code>mono_domain_free</code></div>
370 <div class="mapi-height-container">
371 <div class="mapi-ptr-container"></div>
372 <div class="mapi-description">
373 <div class="mapi-ptr"></div>
374
375 <div class="mapi-declaration mapi-section">Syntax</div>
376 <div class="mapi-prototype">void
377 mono_domain_free (MonoDomain *domain, gboolean force)
378
379 </div>
380 <p />
381 <div class="mapi-section">Parameters</div>
382 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> the domain to release</td></tr><tr><td><i>force</i></td><td> if <code>TRUE</code>, it allows the root domain to be released (used at shutdown only).</td></tr></tbody></table> <div class="mapi-section">Description</div>
383 <div>
384 <p />
385 This releases the resources associated with the specific domain.
386 This is a low-level function that is invoked by the AppDomain infrastructure
387 when necessary.
388 <p />
389 In theory, this is dead code on netcore and thus does not need to be ALC-aware.</div>
390 </div><!--mapi-description -->
391 </div><!--height container -->
392 </div> <!-- class=mapi -->
393
394 <a name="api:mono_domain_from_appdomain"></a>
395 <div class="mapi">
396 <div class="mapi-entry "><code>mono_domain_from_appdomain</code></div>
397 <div class="mapi-height-container">
398 <div class="mapi-ptr-container"></div>
399 <div class="mapi-description">
400 <div class="mapi-ptr"></div>
401
402 <div class="mapi-declaration mapi-section">Syntax</div>
403 <div class="mapi-prototype">MonoDomain*
404 mono_domain_from_appdomain (MonoAppDomain *appdomain_raw)
405
406 </div>
407 <p />
408 </div><!--mapi-description -->
409 </div><!--height container -->
410 </div> <!-- class=mapi -->
411
412 <a name="api:mono_domain_get_by_id"></a>
413 <div class="mapi">
414 <div class="mapi-entry "><code>mono_domain_get_by_id</code></div>
415 <div class="mapi-height-container">
416 <div class="mapi-ptr-container"></div>
417 <div class="mapi-description">
418 <div class="mapi-ptr"></div>
419
420 <div class="mapi-declaration mapi-section">Syntax</div>
421 <div class="mapi-prototype">MonoDomain*
422 mono_domain_get_by_id (gint32 domainid)
423
424 </div>
425 <p />
426 <div class="mapi-section">Parameters</div>
427 <table class="mapi-parameters"><tbody><tr><td><i>domainid</i></td><td> the ID</td></tr></tbody></table> <div class="mapi-section">Return value</div>
428 <div> the domain for a specific domain id.
429 </div>
430 </div><!--mapi-description -->
431 </div><!--height container -->
432 </div> <!-- class=mapi -->
433
434 <a name="api:mono_domain_get_friendly_name"></a>
435 <div class="mapi">
436 <div class="mapi-entry "><code>mono_domain_get_friendly_name</code></div>
437 <div class="mapi-height-container">
438 <div class="mapi-ptr-container"></div>
439 <div class="mapi-description">
440 <div class="mapi-ptr"></div>
441
442 <div class="mapi-declaration mapi-section">Syntax</div>
443 <div class="mapi-prototype">const char *
444 mono_domain_get_friendly_name (MonoDomain *domain)
445
446 </div>
447 <p />
448 <div class="mapi-section">Return value</div>
449 <div> The friendly name of <i>domain</i>. Can be <code>NULL</code> if not yet set.
450 </div>
451 <div class="mapi-section">Description</div>
452 <div>
453 <p />
454 The returned string's lifetime is the same as <i>domain</i>'s. Consider
455 copying it if you need to store it somewhere.
456 <p /></div>
457 </div><!--mapi-description -->
458 </div><!--height container -->
459 </div> <!-- class=mapi -->
460
461 <a name="api:mono_domain_get_id"></a>
462 <div class="mapi">
463 <div class="mapi-entry "><code>mono_domain_get_id</code></div>
464 <div class="mapi-height-container">
465 <div class="mapi-ptr-container"></div>
466 <div class="mapi-description">
467 <div class="mapi-ptr"></div>
468
469 <div class="mapi-declaration mapi-section">Syntax</div>
470 <div class="mapi-prototype">gint32
471 mono_domain_get_id (MonoDomain *domain)
472
473 </div>
474 <p />
475 <div class="mapi-section">Return value</div>
476 <div> The unique ID for <i>domain</i>.
477 </div>
478 <div class="mapi-section">Description</div>
479 <div>
480 <p />
481 A domain ID is guaranteed to be unique for as long as the domain
482 using it is alive. It may be reused later once the domain has been
483 unloaded.
484 <p /></div>
485 </div><!--mapi-description -->
486 </div><!--height container -->
487 </div> <!-- class=mapi -->
488
489 <a name="api:mono_domain_get"></a>
490 <div class="mapi">
491 <div class="mapi-entry "><code>mono_domain_get</code></div>
492 <div class="mapi-height-container">
493 <div class="mapi-ptr-container"></div>
494 <div class="mapi-description">
495 <div class="mapi-ptr"></div>
496
497 <div class="mapi-declaration mapi-section">Syntax</div>
498 <div class="mapi-prototype">MonoDomain*
499 mono_domain_get ()
500
501 </div>
502 <p />
503 <div class="mapi-section">Return value</div>
504 <div> the current domain
505 </div>
506 <div class="mapi-section">Description</div>
507 <div>
508 <p />
509 This method returns the value of the current <code>MonoDomain</code> that this thread
510 and code are running under. To obtain the root domain use
511 <code>mono_get_root_domain</code> API.
512 <p /></div>
513 </div><!--mapi-description -->
514 </div><!--height container -->
515 </div> <!-- class=mapi -->
516
517 <a name="api:mono_domain_has_type_resolve"></a>
518 <div class="mapi">
519 <div class="mapi-entry "><code>mono_domain_has_type_resolve</code></div>
520 <div class="mapi-height-container">
521 <div class="mapi-ptr-container"></div>
522 <div class="mapi-description">
523 <div class="mapi-ptr"></div>
524
525 <div class="mapi-declaration mapi-section">Syntax</div>
526 <div class="mapi-prototype">gboolean
527 mono_domain_has_type_resolve (MonoDomain *domain)
528
529 </div>
530 <p />
531 <div class="mapi-section">Parameters</div>
532 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> application domain being looked up</td></tr></tbody></table> <div class="mapi-section">Return value</div>
533 <div> <code>TRUE</code> if the <code>AppDomain.TypeResolve</code> field has been set.
534 </div>
535 <div class="mapi-section">Description</div>
536 <div>
537 <p /></div>
538 </div><!--mapi-description -->
539 </div><!--height container -->
540 </div> <!-- class=mapi -->
541
542 <a name="api:mono_domain_is_unloading"></a>
543 <div class="mapi">
544 <div class="mapi-entry "><code>mono_domain_is_unloading</code></div>
545 <div class="mapi-height-container">
546 <div class="mapi-ptr-container"></div>
547 <div class="mapi-description">
548 <div class="mapi-ptr"></div>
549
550 <div class="mapi-declaration mapi-section">Syntax</div>
551 <div class="mapi-prototype">gboolean
552 mono_domain_is_unloading (MonoDomain *domain)
553
554 </div>
555 <p />
556 </div><!--mapi-description -->
557 </div><!--height container -->
558 </div> <!-- class=mapi -->
559
560 <a name="api:mono_domain_owns_vtable_slot"></a>
561 <div class="mapi">
562 <div class="mapi-entry "><code>mono_domain_owns_vtable_slot</code></div>
563 <div class="mapi-height-container">
564 <div class="mapi-ptr-container"></div>
565 <div class="mapi-description">
566 <div class="mapi-ptr"></div>
567
568 <div class="mapi-declaration mapi-section">Syntax</div>
569 <div class="mapi-prototype">gboolean
570 mono_domain_owns_vtable_slot (MonoDomain *domain, gpointer vtable_slot)
571
572 </div>
573 <p />
574 <div class="mapi-section">Return value</div>
575 <div> Whether <i>vtable_slot</i> is inside a vtable which belongs to <i>domain</i>.
576 </div>
577 </div><!--mapi-description -->
578 </div><!--height container -->
579 </div> <!-- class=mapi -->
580
581 <a name="api:mono_domain_set_config"></a>
582 <div class="mapi">
583 <div class="mapi-entry "><code>mono_domain_set_config</code></div>
584 <div class="mapi-height-container">
585 <div class="mapi-ptr-container"></div>
586 <div class="mapi-description">
587 <div class="mapi-ptr"></div>
588
589 <div class="mapi-declaration mapi-section">Syntax</div>
590 <div class="mapi-prototype">void
591 mono_domain_set_config (MonoDomain *domain, const char *base_dir, const char *config_file_name)
592
593 </div>
594 <p />
595 <div class="mapi-section">Parameters</div>
596 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> <code>MonoDomain</code> initialized with the appdomain we want to change</td></tr><tr><td><i>base_dir</i></td><td> new base directory for the appdomain</td></tr><tr><td><i>config_file_name</i></td><td> path to the new configuration for the app domain</td></tr></tbody></table> <div class="mapi-section">Description</div>
597 <div>
598 <p />
599 Used to set the system configuration for an appdomain
600 <p />
601 Without using this, embedded builds will get 'System.Configuration.ConfigurationErrorsException:
602 Error Initializing the configuration system. ---&gt; System.ArgumentException:
603 The 'ExeConfigFilename' argument cannot be null.' for some managed calls.</div>
604 </div><!--mapi-description -->
605 </div><!--height container -->
606 </div> <!-- class=mapi -->
607
608 <a name="api:mono_domain_set_internal"></a>
609 <div class="mapi">
610 <div class="mapi-entry "><code>mono_domain_set_internal</code></div>
611 <div class="mapi-height-container">
612 <div class="mapi-ptr-container"></div>
613 <div class="mapi-description">
614 <div class="mapi-ptr"></div>
615
616 <div class="mapi-declaration mapi-section">Syntax</div>
617 <div class="mapi-prototype">void
618 mono_domain_set_internal (MonoDomain *domain)
619
620 </div>
621 <p />
622 <div class="mapi-section">Parameters</div>
623 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> the new domain</td></tr></tbody></table> <div class="mapi-section">Description</div>
624 <div>
625 <p />
626 Sets the current domain to <i>domain</i>.</div>
627 </div><!--mapi-description -->
628 </div><!--height container -->
629 </div> <!-- class=mapi -->
630
631 <a name="api:mono_domain_set"></a>
632 <div class="mapi">
633 <div class="mapi-entry "><code>mono_domain_set</code></div>
634 <div class="mapi-height-container">
635 <div class="mapi-ptr-container"></div>
636 <div class="mapi-description">
637 <div class="mapi-ptr"></div>
638
639 <div class="mapi-declaration mapi-section">Syntax</div>
640 <div class="mapi-prototype">gboolean
641 mono_domain_set (MonoDomain *domain, gboolean force)
642
643 </div>
644 <p />
645 <div class="mapi-section">Parameters</div>
646 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> domain</td></tr><tr><td><i>force</i></td><td> force setting.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
647 <div> <code>TRUE</code> on success; <code>FALSE</code> if the domain is unloaded
648 </div>
649 <div class="mapi-section">Description</div>
650 <div>
651 <p />
652 Set the current appdomain to <i>domain</i>. If <i>force</i> is set, set it even
653 if it is being unloaded.
654 <p /></div>
655 </div><!--mapi-description -->
656 </div><!--height container -->
657 </div> <!-- class=mapi -->
658
659 <a name="api:mono_domain_try_type_resolve"></a>
660 <div class="mapi">
661 <div class="mapi-entry "><code>mono_domain_try_type_resolve</code></div>
662 <div class="mapi-height-container">
663 <div class="mapi-ptr-container"></div>
664 <div class="mapi-description">
665 <div class="mapi-ptr"></div>
666
667 <div class="mapi-declaration mapi-section">Syntax</div>
668 <div class="mapi-prototype">MonoReflectionAssembly*
669 mono_domain_try_type_resolve (MonoDomain *domain, char *name, MonoObject *typebuilder_raw)
670
671 </div>
672 <p />
673 <div class="mapi-section">Parameters</div>
674 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> application domain in which to resolve the type</td></tr><tr><td><i>name</i></td><td> the name of the type to resolve or <code>NULL</code>.</td></tr><tr><td><i>typebuilder</i></td><td> A <code>System.Reflection.Emit.TypeBuilder</code>, used if name is <code>NULL</code>.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
675 <div> A <code>MonoReflectionAssembly</code> or <code>NULL</code> if not found
676 </div>
677 <div class="mapi-section">Description</div>
678 <div>
679 <p />
680 This routine invokes the internal <code>System.AppDomain.DoTypeResolve</code> and returns
681 the assembly that matches name, or ((TypeBuilder)typebuilder).FullName.
682 <p /></div>
683 </div><!--mapi-description -->
684 </div><!--height container -->
685 </div> <!-- class=mapi -->
686
687 <a name="api:mono_domain_try_unload"></a>
688 <div class="mapi">
689 <div class="mapi-entry "><code>mono_domain_try_unload</code></div>
690 <div class="mapi-height-container">
691 <div class="mapi-ptr-container"></div>
692 <div class="mapi-description">
693 <div class="mapi-ptr"></div>
694
695 <div class="mapi-declaration mapi-section">Syntax</div>
696 <div class="mapi-prototype">mono_domain_try_unload</div>
697 <p />
698 </div><!--mapi-description -->
699 </div><!--height container -->
700 </div> <!-- class=mapi -->
701
702 <a name="api:mono_domain_unload"></a>
703 <div class="mapi">
704 <div class="mapi-entry "><code>mono_domain_unload</code></div>
705 <div class="mapi-height-container">
706 <div class="mapi-ptr-container"></div>
707 <div class="mapi-description">
708 <div class="mapi-ptr"></div>
709
710 <div class="mapi-declaration mapi-section">Syntax</div>
711 <div class="mapi-prototype">void
712 mono_domain_try_unload (MonoDomain *domain, MonoObject **exc)
713
714 </div>
715 <p />
716 <div class="mapi-section">Parameters</div>
717 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> The domain to unload</td></tr><tr><td><i>exc</i></td><td> Exception information</td></tr></tbody></table> <div class="mapi-section">Description</div>
718 <div>
719 <p />
720 Unloads an appdomain. Follows the process outlined in:
721 http://blogs.gotdotnet.com/cbrumme
722 <p />
723 If doing things the 'right' way is too hard or complex, we do it the
724 'simple' way, which means do everything needed to avoid crashes and
725 memory leaks, but not much else.
726 <p />
727 It is required to pass a valid reference to the exc argument, upon return
728 from this function *exc will be set to the exception thrown, if any.
729 <p />
730 If this method is not called from an icall (embedded scenario for instance),
731 it must not be called with any managed frames on the stack, since the unload
732 process could end up trying to abort the current thread.</div>
733 </div><!--mapi-description -->
734 </div><!--height container -->
735
736 <h3>Contexts</h3>
737
738 </div> <!-- class=mapi -->
739
740 <a name="api:mono_context_init"></a>
741 <div class="mapi">
742 <div class="mapi-entry "><code>mono_context_init</code></div>
743 <div class="mapi-height-container">
744 <div class="mapi-ptr-container"></div>
745 <div class="mapi-description">
746 <div class="mapi-ptr"></div>
747
748 <div class="mapi-declaration mapi-section">Syntax</div>
749 <div class="mapi-prototype">void
750 mono_context_init (MonoDomain *domain)
751
752 </div>
753 <p />
754 <div class="mapi-section">Parameters</div>
755 <table class="mapi-parameters"><tbody><tr><td><i>domain</i></td><td> The domain where the <code>System.Runtime.Remoting.Context.Context</code> is initialized</td></tr></tbody></table> <div class="mapi-section">Description</div>
756 <div>
757 Initializes the <i>domain</i>'s default <code>System.Runtime.Remoting</code> 's Context.</div>
758 </div><!--mapi-description -->
759 </div><!--height container -->
760 </div> <!-- class=mapi -->
761
762 <a name="api:mono_context_get"></a>
763 <div class="mapi">
764 <div class="mapi-entry "><code>mono_context_get</code></div>
765 <div class="mapi-height-container">
766 <div class="mapi-ptr-container"></div>
767 <div class="mapi-description">
768 <div class="mapi-ptr"></div>
769
770 <div class="mapi-declaration mapi-section">Syntax</div>
771 <div class="mapi-prototype">MonoAppContext*
772 mono_context_get (void)
773
774 </div>
775 <p />
776 <div class="mapi-section">Return value</div>
777 <div> the current Mono Application Context.
778 </div>
779 <div class="mapi-section">Description</div>
780 <div>
781 <p /></div>
782 </div><!--mapi-description -->
783 </div><!--height container -->
784 </div> <!-- class=mapi -->
785
786 <a name="api:mono_context_get_domain_id"></a>
787 <div class="mapi">
788 <div class="mapi-entry "><code>mono_context_get_domain_id</code></div>
789 <div class="mapi-height-container">
790 <div class="mapi-ptr-container"></div>
791 <div class="mapi-description">
792 <div class="mapi-ptr"></div>
793
794 <div class="mapi-declaration mapi-section">Syntax</div>
795 <div class="mapi-prototype">gint32
796 mono_context_get_domain_id (MonoAppContext *context)
797
798 </div>
799 <p />
800 <div class="mapi-section">Parameters</div>
801 <table class="mapi-parameters"><tbody><tr><td><i>context</i></td><td> the context to operate on.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
802 <div> The ID of the domain that <i>context</i> was created in.
803 </div>
804 </div><!--mapi-description -->
805 </div><!--height container -->
806 </div> <!-- class=mapi -->
807
808 <a name="api:mono_context_get_id"></a>
809 <div class="mapi">
810 <div class="mapi-entry "><code>mono_context_get_id</code></div>
811 <div class="mapi-height-container">
812 <div class="mapi-ptr-container"></div>
813 <div class="mapi-description">
814 <div class="mapi-ptr"></div>
815
816 <div class="mapi-declaration mapi-section">Syntax</div>
817 <div class="mapi-prototype">gint32
818 mono_context_get_id (MonoAppContext *context)
819
820 </div>
821 <p />
822 <div class="mapi-section">Parameters</div>
823 <table class="mapi-parameters"><tbody><tr><td><i>context</i></td><td> the context to operate on.</td></tr></tbody></table> <div class="mapi-section">Return value</div>
824 <div> The unique ID for <i>context</i>.
825 </div>
826 <div class="mapi-section">Description</div>
827 <div>
828 <p />
829 Context IDs are guaranteed to be unique for the duration of a Mono
830 process; they are never reused.
831 <p /></div>
832 </div><!--mapi-description -->
833 </div><!--height container -->
834 </div> <!-- class=mapi -->
835
836 <a name="api:mono_context_set"></a>
837 <div class="mapi">
838 <div class="mapi-entry "><code>mono_context_set</code></div>
839 <div class="mapi-height-container">
840 <div class="mapi-ptr-container"></div>
841 <div class="mapi-description">
842 <div class="mapi-ptr"></div>
843
844 <div class="mapi-declaration mapi-section">Syntax</div>
845 <div class="mapi-prototype">void
846 mono_context_set (MonoAppContext * new_context)
847
848 </div>
849 <p />
850 </div><!--mapi-description -->
851 </div><!--height container -->