SLPDereg(3slp)

1SLPDereg(3SLP)    Service Location Protocol Library Functions   SLPDereg(3SLP)
2
3
4

NAME

6       SLPDereg - deregister the SLP advertisement
7

SYNOPSIS

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

DESCRIPTION

17       The  SLPDereg() function deregisters the advertisement for URL pcURL in
18       all scopes where the service is registered and in all language locales,
19       not  just  the  locale of the SLPHandle. If no error occurs, the return
20       value is 0. Otherwise, one of the SLPError codes is returned.
21

PARAMETERS

23       hSLP        The language specific  SLPHandle to use for  deregistering.
24                   hSLP cannot be NULL.
25
26
27       pcURL       The URLto deregister. The value of pcURL cannot be NULL.
28
29
30       callback    A  callback  to  report  the  operation completion  status.
31                   callback cannot be NULL.
32
33
34       pvCookie    Memory  passed  to  the  callback  code  from  the  client.
35                   pvCookie can be NULL.
36
37

ERRORS

39       This  function  or  its callback may return any SLP error code. See the
40       ERRORS section in slp_api(3SLP).
41

EXAMPLES

43       Example 1 Using SLPDereg()
44
45
46       Use the following example to deregister the advertisement for  the  URL
47       "service:ftp://csserver":
48
49
50         SLPerror err;
51         SLPHandle hSLP;
52         SLPRegReport regreport;
53
54         err = SLPDereg(hSLP, "service:ftp://csserver", regreport, NULL);
55
56

ENVIRONMENT VARIABLES

58       SLP_CONF_FILE    When set, use this file for configuration.
59
60

ATTRIBUTES

62       See attributes(5)  for descriptions of the following attributes:
63
64
65
66
67       ┌─────────────────────────────┬─────────────────────────────┐
68       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
69       ├─────────────────────────────┼─────────────────────────────┤
70       │Availability                 │SUNWslpu                     │
71       └─────────────────────────────┴─────────────────────────────┘
72