SLPFindAttrs Subroutine

Purpose

Returns service attributes that match the attribute IDs for the indicated service URL or service type.

Syntax

SLPError SLPFindAttrs(SLPHandle   hSLP,
                         const char *pcURLOrServiceType,
                         const char *pcScopeList,
                         const char *pcAttrIds,
                         SLPAttrCallback callback,
                         void *pvCookie);

Description

The SLPFindAttrs subroutine returns service attributes matching the attribute IDs for the indicated service URL or service type. If pcURLOrServiceType is a service URL, the attribute information returned is for that particular advertisement in the language locale of the SLPHandle.

If pcURLOrServiceType is a service type name (including naming authority if any), then the attributes for all advertisements of that service type are returned regardless of the language of registration. Results are returned through the callback.

The result is filtered with an SLP attribute request filter string parameter. If the filter string is the empty string (""), all attributes are returned.

Parameters

Item	Description
hSLP	The SLPHandle on which to search for attributes.
pcURLOrServiceType	The service URL or service type. Cannot be the empty string.
pcScopeList	A pointer to a char containing a comma-separated list of scope names. Cannot be the empty string, `""`.
pcAttrIds	The filter string indicating which attribute values to return. Use the empty string (`""`) to indicate all values. Wildcards matching all attribute IDs having a particular prefix or suffix are also possible.
callback	A callback function through which the results of the operation are reported.
pvCookie	Memory passed to the callback code from the client. Can be NULL.

Return Values

If SLPFindAttrs is successful, it returns SLP_OK. If an error occurs in starting the operation, one of the SLPError codes is returned.