operation element
Specifies an operation for which code is to be generated.
Usage
<operation/>
Attributes
There are no attributes.
Child elements
There are no child elements.
Parent elements
| Element | Description |
|---|---|
| functionDeclarations |
Generates implementation declarations for proxy functions for port type operations. |
| idlFunctionDeclarations |
Generates IDL declarations for proxy functions for port type operations. |
| messageStructureDefinitions |
Generates C structure definitions for message types. |
| messageTypeDeclarations |
Generates C constant declarations for XML schema tables for message types. |
| messageTypeDefinitions |
Generates C constants for XML schema tables for message types. |
| portTypeDeclarations |
Generates C constant declarations for port types. |
| portTypeDefinitions |
Generates C constants for port types. |
| proxyFunctionImplementations |
Generates implementations for proxy functions for port type operations. |
| stubDeclarations |
Generates declarations for stub functions for port type operations. |
| stubDefinitions |
Generates implementations for stub functions for port type operations. |
| subscriptionFunctionDeclarations |
Generates implementation declarations for subscribe/unsubscribe proxy functions for port type notification operations. |
| subscriptionIdlFunctionDeclarations |
Generates IDL declarations for subscribe/unsubscribe proxy functions for port type notification operations. |
| subscriptionProxyFunctionImplementations |
Generates implementations for subscribe/unsubscribe proxy functions for port type notification operations. |
Remarks
Any number of operations may be specified. If no operations are specified, code is generated for all operations in all the relevant port types. Using the operation element will limit the methods generated to those contained in the operation.
For example, a printer supports these operations among others:
- PrintJobByPost
- PrintJobByReference
- CancelJob
- GetJobElements
- GetActiveJobs
- GetJobHistory
- SubscribeToPrinterConfigChange
- UnsubscribeToPrinterConfigChange
However, to include only the methods related to the PrintJobByPost and GetJobElements operations, the code generation script would use the idlFunctionDeclarations elements as follows:
<idlFunctionDeclarations>
<operation>PrintJobByPost</operation>
<operation>GetJobElements></operation>
</idlFunctionDeclarations>
This generates idl function declarations for all methods associated with the two operations (for example, BeginPrintJobByPost, EndPrintJobByPost, BeginGetJobElements and EndGetJobElements).
Element information
| Label | Value |
|---|---|
| Minimum supported system |
Windows Vista |
| Can be empty | Yes |