SLPFindSrvTypes(3slp)

1SLPFindSrvTypes(3SLSPe)rvice Location Protocol Library FunctiSoLnPsFindSrvTypes(3SLP)
2
3
4

NAME

6       SLPFindSrvTypes - find service types
7

SYNOPSIS

9       cc [ flag... ] file... -lslp [ library... ]
10       #include <slp.h>
11
12       SLPError SLPFindSrvTypes(SLPHandle hSLP, const char *pcNamingAuthority,
13            const char *pcScopeList, SLPSrvTypeCallback *callback, void *pvCookie);
14
15

DESCRIPTION

17       The  SLPFindSrvTypes() function issues an SLP service type request  for
18       service types in the scopes  indicated by the pcScopeList. The  results
19       are  returned  through  the  callback  parameter. The service types are
20       independent of language locale, but only for services registered in one
21       of the scopes and for the indicated naming authority.
22
23
24       If  the naming authority is "*", then results are returned for all nam‐
25       ing authorities. If the naming authority is the empty string, "",  then
26       the default naming authority, IANA, is used. IANA is not a valid naming
27       authority name. The SLP_PARAMETER_BAD error code will  be  returned  if
28       you include it explicitly.
29
30
31       The  service type names are returned with the naming authority included
32       in the following format:
33
34         service-type "." naming-authority
35
36
37
38
39       unless the naming authority is the default, in  which  case,  just  the
40       service type name is returned.
41
42
43       If  an  error  occurs  in starting the operation, one  of  the SLPError
44       codes is returned.
45

PARAMETERS

47       hSLP                 The SLPHandle on which to  search  for  types.  It
48                            cannot  be NULL.
49
50
51       pcNamingAuthority    The  naming  authority to search. Use "*"to search
52                            all naming authorties; use the empty string ""  to
53                            search  the default naming authority. It cannot be
54                            NULL.
55
56
57       pcScopeList          A pointer to a char containing  a  comma-separated
58                            list   of scope names to search for service types.
59                            It cannot be NULL or an empty string, "".
60
61
62       callback             A callback through which the results of the opera‐
63                            tion are reported. It cannot be NULL.
64
65
66       pvCookie             Memory  passed  to  the  callback  code  from  the
67                            client. It can be NULL.
68
69

ERRORS

71       This function or its callback may return any SLP error  code.  See  the
72       ERRORS section in slp_api(3SLP).
73

EXAMPLES

75       Example 1 Using SLPFindSrvTypes()
76
77
78       The following example finds all service type names in the default scope
79       and default naming authority:
80
81
82         SLPError err;
83         SLPHandle hSLP;
84         SLPSrvTypeCallback findsrvtypes;
85
86         err = SLPFindSrvTypes(hSLP, "", "default", findsrvtypes, NULL);
87
88

ENVIRONMENT VARIABLES

90       SLP_CONF_FILE    When set, use this file for configuration.
91
92

ATTRIBUTES

94       See attributes(5)  for descriptions of the following attributes:
95
96
97
98
99       ┌─────────────────────────────┬─────────────────────────────┐
100       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
101       ├─────────────────────────────┼─────────────────────────────┤
102       │Availability                 │SUNWslpu                     │
103       └─────────────────────────────┴─────────────────────────────┘
104