startEnvelope and endEnvelope Methods (Windows CE 5.0)

Send Feedback

These methods begin and end an <Envelope> element in a SOAP message.

HRESULT startEnvelope( BSTRenv_Prefix,BSTRenc_style_uri,BSTRxml_encoding);HRESULT endEnvelope (void);

Parameters

• env_Prefix
  [in] Optional. Namespace for the SOAP elements. The default is "". If the parameter is an empty string or is missing, the application uses the value "SOAP-ENV".
• enc_style_uri
  [in] Optional. Universal Resource Identifier (URI) for the encodingStyle attribute of the <Envelope> element. The following values have special meaning when assigned to this parameter:

  Value	Description
  NONE	Default. Use this value if you do not want encodingStyle attribute generated in <Envelope> element.
  STANDARD	Use this value if you want to generate encodingStyle attribute with the default encoding style in the <Envelope> element.

• xml_encoding
  [in] Optional. XML character encoding used for the SOAP message. The default is "". Uses "UTF-8" if this parameter is missing or is an empty string.

Return Values

The following table describes the common return values.

Remarks

Serializer.startEnvelope() is identical to Serializer.startEnvelope(NONE), which creates this <Envelope> element:

<Envelope>...</Envelope>

Serializer.startEnvelope("STANDARD") creates this <Envelope> element:

<Envelope encodingStyle="https://schemas.xmlsoap.org/soap/encoding/" >...</Envelope>

Serializer.startEnvelope("") creates this <Envelope> element:

<Envelope encodingStyle="">...</Envelope>

Serializer.startBody("SomeEncoding") creates this <Envelope> element:

<Envelope encodingStyle="SomeEncoding">...</Envelope>

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Mssoap.h.
Link Library: Uuid.lib.

See Also

ISoapSerializer

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.