OpenSLP Programmers Guide - SLPParseSrvURL()

SLPParseSrvURL

Declaration

#include <slp.h>

SLPError SLPParseSrvURL( const char* srvurl,
SLPSrvURL** parsedurl )

Description

Parses a Service URL passed in as a character string and returns the results in a pointer to a dynamically allocated SLPSrvURL structure. The pointer returned in parsedurl should be freed by SLPFree().

Parameters

`srvurl`	Pointer to a character buffer containing the null terminated URL string to parse. See Syntax for more information on Service URL syntax.
`parsedurl`	Pointer to a pointer for the `SLPSrvURL` structure that receives the parsed URL. The memory should be freed by a call to SLPFree() when no longer needed.

Returns

SLP_OK	Indicates that the no error occurred during the operation.
SLP_PARSE_ERROR	The service url being parsed is not of valid syntax
SLP_MEMORY_ALLOC_FAILED	Out of memory error
SLP_PARAMETER_BAD	If a parameter passed into a function is bad, this error is returned.
SLP_INTERNAL_SYSTEM_ERROR	A basic failure of the API causes this error to be returned. This occurs when a system call or library fails. The operation could not recover.

Status

OpenSLP 0.6.0