Adding an External Function
You can add an external function to your schema at any time.
To add an external function to the current schema
-
Select the External Functions command from the Browse menu in the Schema, Class, or Primitive Types Browser.
The External Functions Browser is then displayed. The left pane contains a list of the external functions defined in the current schema and the right pane is an editor window that displays the function header of the external function currently selected in the external functions list.
-
Select the Add command from the Functions menu.
The External Functions Definition dialog, shown in the following image, is then displayed.
-
In the Name text box, specify the name of your new external function; for example, findWindow. The external function name has a maximum length of 100 characters.
-
In the Entry Point text box, specify the entry-point name of the function exported from the library; for example, FindWindowW.
Although the entry point name has a maximum length of 255 characters, if you specify an entry point name greater than 100 characters, it must be enclosed in single quote ('') or double quote ("") characters or exception 6007 (Token too long) is raised. (The schema extract process encloses all entry point names in quote characters.)
The Library list box displays the name of the library that you selected in the External Functions Browser; for example, user32. This predefined library is disabled.
The entry point name can include a period, the underscore (_), opening parenthesis ((), closing parenthesis ()), or the ampersand (&) special character. In addition, the entry point name is case-sensitive.
-
Click the Enter Text button if you want to specify or maintain descriptive text for the external function as part of the definition or maintenance of the function.
For details, see "Specifying Text for a Schema Element", in Chapter 3.
You can also specify descriptive text for the external function at any time, by selecting the Text command from the Functions menu. For details, see "Using the Free-Standing Editor Window to Define Text", in Chapter 3.
-
Click the Next button to define your next external function or click the OK button to define your external function and display a template for the function in the editor pane of the External Functions Browser.
The following is an example of an external function template, or signature.
findWindow()is FindWindowW in user32 applicationServerExecution;
Alternatively, click the Cancel button to abandon your selections.
For details about the presentationExecution and applicationServerExecution external function call options, see "
