RPCParameter Property (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/2010

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.

Syntax

HRESULT get_RPCParameter( 
  BSTR LocalName, 
  BSTR NamespaceURI, 
  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 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 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

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

Partager via