SLPDelAttrs

- delete attributes

Synopsis

cc [ flag... ] file... -lslp [ library... ]
#include <slp.h>

SLPError SLPDelAttrs(SLPHandle hSLP, const char *pcURL,
     const char *pcAttrs, SLPRegReport *callback, void *pvCookie);

Description

The SLPDelAttrs() function deletes the selected attributes in the locale of the SLPHandle. If no error occurs, the return value is 0. Otherwise, one of the SLPError codes is returned.

Parameters

hSLP

The language specific SLPHandle to use to delete attributes. It cannot be NULL.

pcURL

The URL of the advertisement from which the attributes should be deleted. It cannot be NULL.

pcAttrs

A comma-separated list of attribute ids for the attributes to deregister.

callback

A callback to report the operation's completion status. It cannot be NULL.

pvCookie

Memory passed to the callback code from the client. It cannot be NULL.

Errors

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

Examples

Example 1 Deleting Attributes

Use the following example to delete the location and dpi attributes for the URL service:printer:lpr://serv/queve1

SLPHandle hSLP;
SLPError err;
SLPRegReport report;

err = SLPDelAttrs(hSLP, "service:printer:lpr://serv/queue1",
    "location,dpi", report, NULL);

Environment Variables

SLP_CONF_FILE

When set, use this file for configuration.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

slpd(1M), slp_api(3SLP), slp.conf(4), slpd.reg(4), attributes(5)

Oracle Solaris Administration: Network Services

Kempf, J. and Guttman, E. RFC 2614, An API for Service Location. The Internet Society. June 1999.