File: sc_enum_apps.xml

package info (click to toggle)
opensc 0.11.1-2etch2
  • links: PTS
  • area: main
  • in suites: etch
  • size: 7,284 kB
  • ctags: 7,257
  • sloc: ansic: 69,499; sh: 9,480; xml: 4,191; makefile: 346; lex: 92; perl: 25
file content (43 lines) | stat: -rw-r--r-- 1,120 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<?xml version="1.0" encoding="UTF-8"?>
<refentry id="scenumapps">
	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
	<refmeta>
		<refentrytitle>sc_enum_apps</refentrytitle>
		<manvolnum>3</manvolnum>
		<refmiscinfo>opensc</refmiscinfo>
	</refmeta>

	<refnamediv>
		<refname>sc_enum_apps</refname>
		<refpurpose>Enumerate the applications on a card</refpurpose>
	</refnamediv>

	<refsect1>
		<title>Synopsis</title>
		<para>
		<programlisting>
#include &lt;opensc.h&gt;

int sc_enum_apps(struct sc_card *card);
		</programlisting>
		</para>
	</refsect1>

	<refsect1>
		<title>Description</title>
		<para>
			This function enumerates the applications on <emphasis>card</emphasis>, and
			stores them in the structure. The list of applications can then later be
			searched with <link linkend="scfindappbyaid">sc_find_app_by_aid()</link> or
			<link linkend="scfindpkcs15app">sc_find_pkcs15_app()</link>.
		</para>
	</refsect1>

	<refsect1>
		<title>Return value</title>
		<para>
			Returns the number of applications on the card, or a negative value in case
			of error.
		</para>
	</refsect1>
</refentry>