RPCParameter Property (Windows CE 5.0)

Article
09/14/2012

This property specifies the first child element of the first entry within the <Body> element of a SOAP message that matches the given local name and namespace URI.

HRESULT get_RPCParameter( BSTRLocalName,BSTRNamespaceURI,IXMLDOMElement** ppElement);

Parameters

LocalName
[in] Local name of the element to retrieve.
NamespaceURI
[in] Optional. Default value is "". The namespace URI of the element to retrieve.
ppElement
[out] Specified parameter 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 example SOAP message 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 RPCParameter property returns either the <NumberOne> or <NumberTwo> element, depending on which element the method requests.

Requirements

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

Share via