OpenSLP Programmers Guide - SLPParseSrvURL()

About
what is openslp

Download
how to get openslp

Contribute
how to help out

Documentation
how to find out more

Credits
who to blame

## SLPParseSrvURL
OpenSLP Programmer's Guide » Parsing Functions » SLPParseSrvURL

### Declaration

    #include <slp.h>

    SLPEXP SLPError SLPAPI 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 | Fully implemented as specified by RFC 2614.

### See Also

SLPFree, SLPTypes, Syntax

Prepared by: Caldera Systems Inc
Maintained by: openslp.org