RPCStruct Property (Windows CE 5.0)

Article
09/14/2012

This property specifies the first entry in the <Body> element of a SOAP message.

HRESULT get_RPCStruct( IXMLDOMElement** ppElement );

Parameters

ppElement
[out] First entry in the <Body> element.

Return Values

The following table describes the common return values.

Value	Description
S_OK	Success.
E_NOTIMPL	The function contains no implementation.
E_OUTOFMEMORY	Out of memory.

Remarks

The RPCParameter, RPCResult, and RPCStruct, properties all relate to SOAP request or response messages that include RPC calls. When a client sends an RPC request to the server or when the client receives a response from the server to the client's RPC request, these properties allow you to access various parts of the RPC call in the message.

The Calc sample application uses some of these properties to access various parts of the RPC call request and response. For more information, see SOAP Samples.

Example

The following SOAP message example requests an RPC operation.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="https://schemas.xmlsoap.org/soap/encoding/" 
        xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
  <m:AddNumbers xmlns:m="https://localhost/DocSample1/DocSample1.xsd">
    <NumberOne>2</NumberOne>
    <NumberTwo>3</NumberTwo>
  </m:AddNumbers>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

In this case, the RPCStruct property specifies the <m:AddNumbers> element.

Requirements

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

Share via