Share via


Add Method Wizard

Use this wizard to add a method to an interface. Depending on the project type or interface type to which you are adding a method, the wizard displays different options.

Names

  • Return type
    The data type returned by the method. HRESULT is recommended for all interface types, because it provides a standard way to return errors.

    Interface type

    Description

    Dual interface

    HRESULT. Unchangeable.

    Custom interface

    HRESULT. Unchangeable.

    Local custom interface

    Provide your own return type or select from the list.

    Dispinterface

    Provide your own return type or select from the list.

    MFC ActiveX control dispinterface

    If you implement a stock method, the return type is set to the appropriate value and is unchangeable. If you select a method from the Method name list and click Custom under Select method type, select a return type from the list.

  • Method name
    Sets the name for the method.

    Interface type

    Description

    ATL dual interface, custom interface, and local custom interface

    Provide your own method name.

    MFC dispinterface

    Provide your own method name or select a suggested method name from the list. If you select a name from the list, the appropriate value appears in the Return type box, and it is unchangeable.

    MFC ActiveX control dispinterface

    Provide your own or select either of the stock methods DoClick and Refresh. See MFC ActiveX Controls: Adding Stock Methods for more information.

  • Method type
    Available only for MFC ActiveX controls. If you provide a method name in the Method name box, rather than selecting a method from the list, this box is unavailable.

    If you select one of the methods in the Method name list, select either the stock implementation or a custom implementation.

    Method type

    Description

    Stock

    The default. Inserts the stock implementation of the method you select in the Method name list. Return type is unchangeable if you select Stock.

    Custom

    Inserts a stub implementation of the method selected in the Method name list. For custom method types, you can provide your own return type, or you can select one from the Return type list.

  • Internal name
    Available for only custom methods added to an MFC dispinterface. Sets the name used in the dispatch map, the header (.h) file, and the implementation (.cpp) file. By default, this name is the same as Method name. You can change the method name if you are working with an MFC dispinterface or if you are adding a custom method to an MFC ActiveX control dispinterface.

    Interface type

    Description

    ATL dual interface, custom interface, and local custom interface

    Not available

    MFC dispinterface

    Set to the method name by default. You can edit the internal name.

    MFC ActiveX control dispinterface

    You can set the internal name only for custom methods. Stock methods do not use an internal name.

  • Parameter attributes
    Sets any additional attributes for parameter specified in Parameter name.

    Parameter attribute

    Description

    Allowed combinations

    In

    Indicates that the parameter is passed from the calling procedure to the called procedure.

    in only

    in and out

    Out

    Indicates that the pointer parameter is returned from the called procedure to the calling procedure (from the server to the client).

    out only

    in and out

    out and retval

    Retval

    Indicates that the parameter receives the return value of the member.

    retval and out

  • Parameter type
    Sets the data type of the parameter. Select the type from the list.

  • Parameter name
    Sets the name of a parameter to pass through your method. After typing the name, you must click Add to add it to the list of parameters that will pass through your method. If you do not provide a parameter name, the wizard ignores any parameter attributes (ATL only) or Parameter type selections.

    Once you click Add, the parameter name appears in Parameter list.

    Note   If you supply a parameter name and then click Finish before you click Add, the parameter is not added to the method. You must find the method and insert the parameter manually.

  • Add
    Adds the parameter you specify in Parameter name, and its type and parameter attributes, to Parameter list. You must click Add to add a parameter to the list.

  • Remove
    Removes the parameter you select in Parameter list from the list.

  • Parameter list
    Displays all parameters and their modifiers and types currently added for the method. As you add parameters, the wizard updates Parameter list to display each parameter, with its modifier and type.

See Also

Tasks

Adding a Method

Reference

IDL Attributes, Add Method Wizard