ProxyGen Descriptor Schema Reference

The Proxy Generation tool (ProxyGen.exe) uses the ProxyGen descriptor schema to generate XML proxy descriptor files. Proxy descriptor files contain an XML representation of the types in the COM type library or managed assembly that contains your application's object model. If you modify the object model by editing the proxy descriptor file, your changes must validate according to the ProxyGen descriptor schema. For more information, see Defining Entry Points and Other Proxy Changes.

The ProxyGen descriptor schema is named ProxyGenDescriptorV2.xsd, and is installed by default to the following folder on your development computer: %ProgramFiles%\Visual Studio Tools for Applications 2.0 SDK\build number\Visual Studio Tools For Applications\Schemas.

The root element is the Library element. The following table describes all of the elements defined by the ProxyGen descriptor schema.

Element

Description

Attribute

Represents an attribute of a type, member, or parameter.

BaseType

Represents a base type that another type derives from.

Class Element for COMLibrary

Represents a proxy class for a COM class in the host application's object model.

Class Element for ManagedLibrary

Represents a proxy class for a managed class in the host application's object model.

COMLibrary

Represents the contents of a COM type library that contains the host application's object model.

Constant

Represents a constant that is defined in a proxy type for a COM or managed type.

DeclaringType

Represents the interface or base type in which a member is declared, if the member is an explicit interface implementation or an override.

DefaultNullValue

Indicates that a parameter has a null default value.

DefaultValue

Specifies the default value of a parameter.

Delegate

Represents a proxy delegate for a managed delegate that is defined in a parent class, or represents a proxy delegate that handles a COM event.

Delegate Element for ManagedLibrary

Represents a proxy delegate for a managed delegate that is not defined in a parent class.

Enum

Represents a proxy enumeration for a COM or managed enumeration.

EnumerationValue

Represents a member of a proxy enumeration for a COM or managed enumeration.

Event Element for Class for COMLibrary

Represents an event that is defined in a proxy type for a COM type.

Event Element for Class for ManagedLibrary

Represents an event that is defined in a proxy type for a managed type.

Exception

Represents a proxy exception for a managed exception.

ExternalTypeReference

Describes a type that is not defined in the proxy descriptor file. The type can be an array.

ExternalTypeReference Element for Type for Attribute or Event

Describes a type that is not defined in the proxy descriptor file. The type cannot be an array.

ExternalTypeReference Element for UnderlyingType

Describes the underlying integral type of an enumeration.

Field

Represents a field that is defined in a proxy exception for a managed exception.

Get

Represents the get accessor of a property of a COM or managed type.

ImplementedInterface

Represents an interface that another type implements.

Interface Element for COMLibrary

Represents a proxy interface for a COM interface in the host application's object model.

Interface Element for ManagedLibrary

Represents a proxy interface for a managed interface in the host application's object model.

Library

Required root element of a proxy descriptor file generated by using ProxyGen.exe. The proxy descriptor file describes the contents of either a COM type library or a managed assembly.

ManagedLibrary

Represents the contents of a managed assembly that contains the host application's object model.

Method Element for Class for COMLibrary

Represents a method that is defined in a proxy type for a COM type.

Method Element for Class for ManagedLibrary

Represents a method that is defined in a proxy type for a managed type.

NamedNullParameter

Represents a named parameter of an attribute's constructor that is passed the value null.

NamedParamter

Represents a named parameter of an attribute's constructor.

NullParameter

Represents a positional parameter of an attribute's constructor that is passed the value null.

NullValue

Indicates that a constant has a null value.

Parameter

Represents a parameter of a member or delegate type.

Parameter Element for Attribute

Represents a positional parameter of an attribute's constructor.

Property Element for Class for COMLibrary

Represents a property that is defined in a proxy type for a COM type.

Property Element for Class for ManagedLibrary

Represents a property that is defined in a proxy type for a managed type.

ReturnType

Represents the type of the return value of a method.

ReturnValueAttribute

Represents an attribute that is applied to the return value of a member or delegate type.

Set

Represents the set accessor of a property of a COM or managed type.

Struct Element

Represents a proxy class for a managed struct in the host application's object model.

Type

Represents a reference to a type that is used in the declaration of a member or parameter.

Type Element for Attribute or Event

Represents a reference to a type that is used in the declaration of an attribute or event.

TypeReference

Describes a type that is defined in the proxy descriptor file. The type can be an array.

TypeReference Element for Type for Attribute or Event

Describes a type that is defined in the proxy descriptor file. The type cannot be an array.

UnderlyingType

Represents the underlying integral type of a proxy enumeration for a COM or managed enumeration.

Value

Specifies the value of a constant.

See Also

Tasks

Walkthrough: Creating a Proxy Assembly

Concepts

Creating Proxies

Reference

Proxy Generation Tool (ProxyGen.exe)