SOAP Header structure. More...
SOAP Header structure.
This structure is generated by the wsdl2h tool from a WSDL with SOAP Header definitions and/or by soapcpp2 to complete the SOAP Header definitions. The SOAP Header definitions can also be specified manually in the interface header file for soapcpp2. If no SOAP Header structure is declared in the interface header file input to soapcpp2 then the soapcpp2 tool will generate an empty structure.
A SOAP Header contains meta-data, such as WS-Addressing and WS-Security headers, associated with messages. SOAP Header elements may be marked with
mustUnderstand which produces and recognizes
SOAP_ENV:mustUnderstand="true" in XML to force the receiver to produce an error if the header element was not recognized.
//gsoap <prefix> service method-input-header-part: and
//gsoap <prefix> service method-output-header-part: directives indicates which member (i.e. XML element) of
SOAP_ENV__Header is relevant to the input and output SOAP Headers associated with a service operation.
Because this structure is declared
mutable (which is a C/C++ extension that only soapcpp2 understands), multiple
SOAP_ENV__Header structures in the interface header file input are combined into one structure generated by soapcpp2 for C/C++ compilation.