COM/DCOM > Filter Recording Options

Enables you to define which COM/DCOM objects to record.

To access

Use one of the following:

  • Record > Recording Options > COM/DCOM > Filter
  • Replay > Recording Options > COM/DCOM > Filter

User interface elements are described below:

UI Element
Description
DCOM Profile
Specify one of the following filter types:
  • Default Filter. The filter to be used as the default when recording a COM Vuser script.

  • New Filter. A clean filter based on the default environment settings. Note that you must specify a name for this filter before you can record with its settings.

You can also save the current settings and delete a filter using the Save As and Delete buttons.
DCOM Listener Settings List
Displays a tree hierarchy of type libraries. You can expand the tree to show all of the available classes in the type library. You can expand the class tree to show all of the interfaces supported by that class.
To exclude a type library, clear the check box next to the library name. This excludes all of its classes in that type library. By expanding the tree, you can exclude individual classes or interfaces by clearing the check box next to the item.
An interface can be implemented differently by various classes. When you exclude an interface that is implemented by other classes that have not been excluded, a dialog box opens asking you if you also want to exclude the interface in all classes that implement it this interface.
Note that when you clear the check box adjacent to an interface, it is equivalent to selecting it in the Excluded Interfaces dialog box.
  • Environment. The environments to record: ADO objects, RDS Objects, and Remote Objects. Clear the objects you do not want to record.

  • Type Libraries. A type library .tlb or .dll file, that represents the COM object to record. All COM objects have a type library that represents them. You can select a type library from the Registry, Microsoft Transaction Server, or file system.

Type Libraries. In the lower section of the dialog box, VuGen displays the following information for each type library.
  • TypLib. The name of the type library (tlb file).

  • Path. The path of the type library.

  • Guid. The Global Unique Identifier of the type library.

Adds another COM type library.
  • Browse Registry. Displays a list of type libraries found in the registry of the local computer. Select the check box next to the desired library or libraries and click OK.

  • Browse file system. Allows you to select type libraries from your local file system.

  • Browse MTS. add a component from a Microsoft Transaction Server. The MTS Components dialog box prompts you to enter the name of the MTS server.

  • Type the name of the MTS server and click Connect. Remember that to record MTS components you need an MTS client installed on your machine.
    Select one or more packages of MTS components from the list of available packages and click Add. Once the package appears in the list of Type Libraries, you can select specific components from the package.

Removes a COM type library.

Excludes interfaces in the filter through the Excluded Interfaces dialog box.
In this dialog box, the checked interface listings are the ones that are excluded. You can also add interfaces that are not listed. Click Add Interface... in the Excluded Interfaces dialog box and enter the GUID number (interface ID) and name of the interface. You can copy the GUID from the interfaces.h file created by VuGen and listed in the selection tree in the left-hand column of the VuGen screen. Use the Add Interface... feature to exclude interfaces that are called needlessly by the script, but are not listed anywhere in the filter.
An interface can be implemented differently by various classes. When you exclude an interface that is implemented by other classes that have not been excluded, VuGen displays the a warning. If you check Don't ask me again and close the dialog box, then the status of all instances of the interface in all other classes will be changed automatically for this filter, whenever you change the status of the interface in one object. Click Yes to all to change the status of all instances of this interface for all other classes, click No to all to leave the status of all other instances unchanged. Click Next Instance to view the next class that uses this interface.
Back to top