debian/openslp-dfsg/openslp-dfsg-1.2.1/doc/html/ProgrammersGuide/SLPGetRefreshInterval.html


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

<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <meta name="GENERATOR" content="Mozilla/4.72C-CCK-MCD Caldera Systems OpenLinux [en] (X11; U; Linux 2.2.14 i686) [Netscape]">
   <title>OpenSLP Programmers Guide - SLPGetRefreshInterval()</title>
</head>
<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000">

<h2>
SLPGetRefreshInterval</h2>

<hr WIDTH="100%">
<h3>
Declaration</h3>
<tt>#include &lt;slp.h></tt>
<p><tt>unsigned short SLPGetRefreshInterval()</tt>
<h3>
Description</h3>
Returns the minimum refresh interval that will be accepted by all SLP agents
on the network.
<h3>
Parameters</h3>
None
<h3>
Returns</h3>
A positive integer value that is the smallest value that should be passed
as a <tt><a href="SLPReg.html#lifetime">lifetime</a></tt> to <tt><a href="SLPReg.html">SLPReg()</a></tt>.&nbsp;
If no agents advertise a minimum refresh interval, then zero is returned.
( Zero is not a valid value for the <tt><a href="SLPReg.html#lifetime">lifetime</a></tt>
parameter to <a href="SLPReg.html">SLPReg()</a> .)
<br>&nbsp;
<h3>
Status</h3>

<table CELLPADDING=5 NOSAVE >
<tr VALIGN=TOP NOSAVE>
<td NOSAVE>OpenSLP 0.7.8</td>

<td NOSAVE>Not Implemented.&nbsp; Always returns SLP_NOT_IMPLEMENTED</td>
</tr>
</table>

<h3>
Notes</h3>
RFC 2614 is really not clear as to how this function works.&nbsp; In fact
the RFC declares the return to be of type <tt>unsigned short</tt> and specifies
that (negative) <a href="SLPError.html">SLPError</a> codes are returned
on error.&nbsp; Since a negative return could also be interpreted as (a
very large) unsigned value, OpenSLP does not return <a href="SLPError.html">SLPError</a>
codes cast to unsigned shorts it just returns zero.
<h3>
See Also</h3>
<a href="SLPReg.html">SLPReg()</a>
</body>
</html>