HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)

s
SLPError(3N) SLPError(3N)
NAME
SLPError - SLP (Service Location Protocol) Error codes
SYNOPSIS
#include <slp.h> typedef int SLPError;
DESCRIPTION
SLP Error Codes
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 operation. 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 informa-
tion 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 registration.
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 property 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 mes-
sage 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.
SLP_NOT_IMPLEMENTED -17
Section 3−−970 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003