RPCStruct Property (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/2010

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

Syntax

HRESULT get_RPCStruct( 
  IXMLDOMElement** ppElement 
);

Parameters

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

Return Value

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

Header	mssoap.h
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

Partager via