MSPL Built-in Functions
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
MSPL Built-in Functions
The Microsoft SIP Processing Language (MSPL) provides several built-in functions that are useful for common SIP application tasks, such as message forking, the creation of proxy objects, and parameter parsing.
Certain functions, such as BeginFork/Fork/EndFork, must be called in a certain order; otherwise, an error will be generated. Other functions must be called only when the message being processed is a request or a response; otherwise, a critical error will also be generated. If 10 critical errors of this type are generated during run time, the application will be disabled.
MSPL defines the built-in functions described in the following table.
Function |
Description |
---|---|
Adds a header to the current SIP message. |
|
Initializes a forking operation for the current message. |
|
Indicates whether the user is enabled for a specified option. |
|
Concatenates a sequence of supplied string values, in parameter order. |
|
Searches for an occurrence of one specified string within another. |
|
Dispatches an event to a supplied event handler within the application. |
|
Indicates whether a message was successfully queued. |
|
Indicates whether a specified domain is supported by the registrar on the Office Communications Server server executing this script. |
|
Sends the current set of forked messages using the forking proxy initialized with BeginFork. |
|
Determines whether two supplied strings are equal. |
|
Creates a forked copy of the current message with its request URI field set to the supplied URI string. |
|
Returns the display name associated with a supplied SIP address. |
|
Returns a string representation of the instance ID from the GRUU. |
|
Returns a collection of strings containing the values associated with the supplied header name in the current SIP message. |
|
Returns the hostname portion of a supplied SIP URI. |
|
Returns the value of a named parameter within a SIP header string. |
|
Returns the port specified in a SIP URI. |
|
Returns the scheme associated with the SIP URI. |
|
Returns the URI portion of a SIP address, such as the address found in the From or To header field of a SIP message. |
|
Returns the named parameter value found in a supplied SIP URI. |
|
Extracts user@hostname from a URL. |
|
Returns the user name portion of a SIP URI. |
|
Computes a hash value from a string. |
|
Returns an index of the first occurrence of a specified string. |
|
Indicates whether a specified URI is formatted as a GRUU. |
|
Indicates whether a specified URI points to a phone. |
|
Returns the number of characters in a string. |
|
Writes an entry or entries to the specified server log. |
|
Proxies the current SIP request to the supplied URI. |
|
Proxies the current SIP response to the next destination in its route. |
|
Fetches an item published in a specified enhanced presence container. |
|
Fetches an item published in a specified enhanced presence container which is selected based on the access control lists associated with the indicated Subscriber and ExternalSourceNetwork. |
|
Indicates whether a specified domain belongs to a specified domain type. |
|
Queries the server registrar for the network endpoints associated with a specified user and hostname combination. |
|
Returns the fully qualified domain name of the home server for a specified SIP user. |
|
Returns an XML fragment containing the policy assigned to the specified user based on server configuration. |
|
Generates a SIP response to the current request message with the supplied status code and reason phrase. |
|
Adds or sets a specific parameter value in a SIP header. |
|
Splits a string on a specified separator substring and returns a string collection. |
|
Tests whether one domain is a subdomain of another specified domain. |
|
Extracts a specified string from a larger string. |
|
Determines whether a specific SIP method is supported by the application. |