SLPFindSrvTypes Subroutine

Edit online

Purpose

Issues an SLP service type request.

Syntax

SLPError SLPFindSrvTypes(SLPHandle    hSLP,
                            const char  *pcNamingAuthority,
                            const char  *pcScopeList,
                            SLPSrvTypeCallback callback,
                            void *pvCookie);

Description

The SLPFindSrvType() subroutine issues an SLP service type request for service types in the scopes indicated by the pcScopeList. The results are returned through the callback parameter. The service types are independent of language locale, but only for services registered in one of the scopes and for the naming authority indicated by pcNamingAuthority.

If the naming authority is "*", then results are returned for all naming authorities. If the naming authority is the empty string, "", then the default naming authority, "IANA", is used. "IANA" is not a valid naming authority name, and it returns a PARAMETER_BAD error when it is included explicitly.

The service type names are returned with the naming authority intact. If the naming authority is the default (that is, the empty string), then it is omitted, as is the separating ".". Service type names from URLs of the service: scheme are returned with the "service:" prefix intact.

Parameters

Item Description
hSLP The SLPHandle on which to search for types.
pcNamingAuthority The naming authority to search. Use "*" for all naming authorities and the empty string, "", for the default naming authority.
pcScopeList A pointer to a char containing a comma-separated list of scope names to search for service types. Cannot be the empty string, "".
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 SLPFindSrvTypes is successful, it returns SLP_OK. If an error occurs in starting the operation, one of the SLPError codes is returned.