SLPError.3n (2010 09)

s
SLPError(3N) SLPError(3N)
NAME
SLPError - Service Location Protocol (SLP) error codes
SYNOPSIS
#include <slp.h>
typedef int SLPError;
DESCRIPTION
SLP APIs return error code when the call does not succeed. These SLP error codes are defined in
<slp.h>.
The various SLP Error codes returned by the SLP APIs, their values and their explanations are as fol-
lows:
SLP_LAST_CALL
(1)
Passed to callback functions when the API library has no more data for them and therefore no
further calls will be made to the callback on the currently outstanding operation. The callback can
then signal to the main body of the client code that no more data will be forthcoming on the opera-
tion. The main body of the client code will then break out of data collection loops. On the last call
of a callback during both an asynchronous and synchronous calls, the error code parameter has
value
SLP_LAST_CALL, and the other parameters are all NULL. If no results are returned by an
API operation, then only one call is made, with the error parameter set to SLP_LAST_CALL
.
SLP_OK (0)
Indicates that no error occurred during the operation.
SLP_LANGUAGE_NOT_SUPPORTED
(-1)
There is no DA or SA service advertisement or attribute information in the language requested.
However, at least one DA or SA indicates that there might be information for that service in another
language by returning the
LANGUAGE_NOT_SUPPORTED
error code.
SLP_PARSE_ERROR (
-2)
The SLP message was rejected by a remote SLP agent. The API returns this error only when no
information was retrieved, and at least one SA or DA indicated a protocol error. The data supplied
through the API may be malformed or a may have been damaged in transit.
SLP_INVALID_REGISTRATION
(-3)
The API may return this error if an attempt to register a service was rejected by all DAs because of
a malformed URL or attributes. SLP does not return the error if at least one DA accepted the regis-
tration.
SLP_SCOPE_NOT_SUPPORTED
(-4)
The API returns this error if the SLP request packet did not specify one or more of the scopes that
neither slpd running on local machine has been configured with through the net.slp.useScopes pro-
perty in the configuration file nor is there slpd running on any other machines which support them.
SLP_AUTHENTICATION_ABSENT (-6)
If the SLP framework supports authentication, this error arises when the UA or SA failed to send
an authenticator for requests or registrations in a protected scope.
SLP_AUTHENTICATION_FAILED (-7)
If the SLP framework supports authentication, this error arises when a authentication on an SLP
message failed.
SLP_INVALID_UPDATE (-13)
An update for a non-existing registration was issued or the update includes a service type or scope
different than that in the initial registration or successive incremental registrations.
SLP_REFRESH_REJECTED (-15)
The SA attempted to refresh a registration more frequently than the minimum refresh interval. The
SA should call the appropriate API function to obtain the minimum refresh interval to use.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1