Tribblix: manual page: SLPDelAttrs.3slp

SLPDELATTRS(3SLP) Service Location Protocol Library Functions

NAME

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.