Edit

Share via


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