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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
<!--plsfield:text-->
<HTML><HEAD>
<TITLE>C API Reference -- Ns_ConfigGetValue</TITLE>
<LINK rel=Previous href="c-ch56.htm">
<LINK rel=ToC href="toc.htm">
<LINK rel=Index href="master.htm">
<LINK rel=Next href="c-ch58.htm">
</HEAD><BODY BGCOLOR="#ffffff"><A NAME="topofpage"></A>
<TABLE WIDTH=100%>
<TR>
<TD ALIGN=LEFT>
<A NAME="topofpage"></A> <IMG SRC="as-c-sm.gif">
</TD>
<TD ALIGN=RIGHT>
<A href="c-ch56.htm"><IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A>
<A href=toc.htm> <IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A>
<A href=master.htm> <IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A>
<A href="c-ch58.htm"> <IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A>
<A name="7983"> </A>
</TD>
</TR>
</TABLE>
<a name="213787">
</a><h3>Ns_ConfigGetValue</h3>
<a name="90220">
</a><h4>Overview</h4>
Get a configuration file variable
<a name="61790">
</a><a name="132331">
</a><h4>Syntax</h4>
<pre> <a name="61792"></a>char *Ns_ConfigGetValue(
<a name="61793"></a>char *sectionName,
<a name="61794"></a>char *key
<a name="61795"></a>);
</pre><p><a name="133659">
</a><h4>Description</h4>
<p><a name="61797">
</a>This function returns the value for the given <code>key</code> in the section named <code>sectionName</code>. If either the section does not exist or the key does not exist in the section, the function returns <code>NULL</code>. If multiple keys of the same name are in the named section (for example, the multiple Load lines of the Modules section), this function returns only the first matching entry. The section names must match exactly, but the key will be matched case-insensitively. Ns_ConfigGetValueExact is the case-sensitive counterpart of this function.</p>
<p><a name="213862">
</a>The space for the string returned is located in the configuration data. You must not deallocate or modify the string.</p>
<a name="213870">
</a><h4>Examples</h4>
<pre> <a name="213868"></a> /* Fetch the home directory of the AOLserver. */
<a name="213890"></a>
<a name="213889"></a> char *home;
<a name="213879"></a>
<a name="213880"></a> home = Ns_ConfigGetValue("ns/parameters", "Home");
</pre><p>
<TABLE BORDER="2" CELLPADDING="1" width="100%">
<TR><TD COLSPAN=3><P ALIGN=Center>
<IMG SRC="bluebult.gif">
<A HREF="#topofpage">
<FONT SIZE=-1>Top of Page</FONT></A>
<IMG SRC="bluebult.gif">
</TD></TR>
<TR><TD COLSPAN=3><P ALIGN=Center>
<A href="c-ch56.htm">
<IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A>
<A href=toc.htm>
<IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A>
<A href=master.htm>
<IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A>
<A href="c-ch58.htm">
<IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A>
<BR align=center>
<FONT size=-1>Copyright © 1998-99 America Online,
Inc.</FONT>
</TD></TR></TABLE></BODY></HTML><!--plsfield:end-->
|
