blob: 4b5ebc79a6b0d534237aa6a2dfd52e97e227ab6f (
plain)
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
<!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.77C-CCK-MCD Caldera Systems OpenLinux [en] (X11; U; Linux 2.4.2 i686) [Netscape]">
<title>OpenSLP Programmers Guide - SLPSrvURLCallback</title>
</head>
<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000">
<h2>
SLPSrvURLCallback</h2>
<hr WIDTH="100%">
<h3>
Declaration</h3>
<tt>typedef <a href="SLPTypes.html#SLPBoolean">SLPBoolean</a> SLPSrvURLCallback(
<a href="SLPTypes.html#SLPHandle">SLPHandle</a>
<a href="#hslp">hslp</a>,</tt>
<br><tt>
const char* <a href="#srvurl">srvurl</a>,</tt>
<br><tt>
unsigned short <a href="#lifetime">lifetime</a>,</tt>
<br><tt>
<a href="SLPTypes.html#SLPError">SLPError</a> <a href="#errcode">errcode</a>,</tt>
<br><tt>
void* <a href="#cookie">cookie</a> )</tt>
<h3>
Description</h3>
The <tt>SLPSrvURLCallback</tt> type is the type of the callback function
parameter to <tt>SLPFindSrvs()</tt> function. If the <tt>hslp</tt> handle
parameter was opened asynchronously, the results returned through the callback
MAY be uncollated.
<h3>
Parameters</h3>
<table BORDER CELLPADDING=5 NOSAVE >
<tr VALIGN=TOP NOSAVE>
<td NOSAVE><a NAME="hslp"></a><tt>hslp</tt></td>
<td NOSAVE>The language specific <tt>SLPHandle</tt> on which to register
the service.</td>
</tr>
<tr VALIGN=TOP NOSAVE>
<td NOSAVE><a NAME="srvurl"></a><tt>srvurl</tt></td>
<td>Pointer to the SLP Service URL of the requested service. See
<a href="Syntax.html">Syntax</a>
for more information about SLP Service URLs</td>
</tr>
<tr VALIGN=TOP NOSAVE>
<td NOSAVE><a NAME="lifetime"></a><tt>lifetime</tt></td>
<td NOSAVE>The lifetime of the service in seconds</td>
</tr>
<tr VALIGN=TOP NOSAVE>
<td><a NAME="errcode"></a><tt>errcode</tt></td>
<td NOSAVE>An error code indicating if an error occurred during the operation.
The callback should check this error code before processing the parameters. </td>
</tr>
<tr VALIGN=TOP NOSAVE>
<td NOSAVE><a NAME="cookie"></a><tt>cookie</tt></td>
<td NOSAVE>The same cookie that was passed as a parameter to the <tt>SLPFindSrvs()</tt>
call</td>
</tr>
<caption ALIGN=BOTTOM> </caption>
</table>
<h3>
Returns</h3>
The callback should return <tt>SLP_TRUE</tt> if more data is desired.
The callback may continue to return <tt>SLP_TRUE</tt> until it is called
with an errcode of <tt>SLP_LAST_CALL</tt>. If no more data is requested
the callback should return <tt>SLP_FALSE</tt>.
<br>
<h3>
Status</h3>
<table CELLPADDING=5 NOSAVE >
<tr VALIGN=TOP NOSAVE>
<td NOSAVE>OpenSLP 0.6.0</td>
<td NOSAVE>SLPSrvURLCallback functions are called as specified by RFC 2614</td>
</tr>
</table>
<h3>
See Also</h3>
<a href="/Syntax.html">Syntax</a>,
<a href="/Callbacks.html">Callbacks</a>
<br>
<br>
</body>
</html>
|
