Edit

operation element

  • Article

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