Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 10.0.1 » SQL Anywhere Server - SQL Reference » SQL Functions » Alphabetical list of functions

SIN function [Numeric] Next Page

SOAP_HEADER function [SOAP]


Returns a SOAP header entry, or an attribute value for a header entry of the SOAP request.

Syntax

SOAP_HEADER( header-key [ index, header-attribute ] )

Parameters

header-key    This VARCHAR parameter specifies the XML local name of the top level XML element for a given SOAP header entry.

index    This optional INTEGER parameter differentiates between SOAP header fields that have identical names. This can occur when multiple header entries have top level XML elements with the same localname. Usually, such elements have unique namespaces.

header-attribute    This optional VARCHAR parameter can be any attribute node within a header entry element, including:

Remarks

This function may be used with a single parameter header-key to return a header entry. A header entry is an XML string representation of an element, and all its sub-elements, contained within a SOAP header.

This function may also be used to extract a header entry attribute by specifying the optional index and header-attribute parameters.

This function returns the value of the named SOAP header field, or NULL if not called from a SOAP service. It is used when processing a SOAP request via a web service.

If a header for the given header-key does not exist, the return value is NULL.

See also
Standards and compatibility