|SLPREG(3SLP)||Service Location Protocol Library Functions||SLPREG(3SLP)|
cc [ flag... ] file... -lslp [ library... ] #include <slp.h> SLPError SLPReg(SLPHandle hSLP, const char *pcSrvURL, const unsigned short usLifetime, const char *pcSrvType, const char *pcAttrs, SLPBoolean fresh, SLPRegReport callback, void *pvCookie);
The SLPReg() function registers the URL in pcSrvURL having the lifetime usLifetime with the attribute list in pcAttrs. The pcAttrs list is a comma-separated list of attribute assignments in on-the-wire format (including escaping of reserved characters). The sLifetime parameter must be nonzero and less than or equal to SLP_LIFETIME_MAXIMUM. If the fresh flag is SLP_TRUE, then the registration is new, the SLP protocol fresh flag is set, and the registration replaces any existing registrations.
The pcSrvType parameter is a service type name and can be included for service URLs that are not in the service: scheme. If the URL is in the service: scheme, the pcSrvType parameter is ignored. If the fresh flag is SLP_FALSE, then an existing registration is updated. Rules for new and updated registrations, and the format for pcAttrs and pcScopeList, can be found in RFC 2608. Registrations and updates take place in the language locale of the hSLP handle.
The API library is required to perform the operation in all scopes obtained through configuration.
This function or its callback may return any SLP error code. See the ERRORS section in slp_api(3SLP).
The following example shows an initial registration for the "service:video://bldg15" camera service for three hours:
SLPError err; SLPHandle hSLP; SLPRegReport regreport; err = SLPReg(hSLP, "service:video://bldg15", 10800, "", "(location=B15-corridor), (scan-rate=100)", SLP_TRUE, regRpt, NULL);
System Administration Guide: Network Services
Guttman, E., Perkins, C., Veizades, J., and Day, M. RFC 2608, Service Location Protocol, Version 2. The Internet Society. June 1999.
Kempf, J. and Guttman, E. RFC 2614, An API for Service Location. The Internet Society. June 1999.
|January 16, 2003||OmniOS|