RPCParameter Property (Windows Embedded CE 6.0)
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 |