COM
id
in
int
odl
out
ptr
ref
Expand Minimize

import attribute

The import directive specifies another IDL, ODL, or header file containing definitions you wish to reference from your main IDL file.


import "filename" [[ , ... ]] ;

Parameters

filename

Specifies the name of the header, IDL, or ODL file to import.

Remarks

With the import directive, all IDL statements in the imported file, such as typedefs, constant declarations, and interface definitions become available to the importing .IDL file.

The imported file is processed separately (meaning that CPP preprocessor is invoked independently) from the importing IDL file. In this way, pre-processor directives, such as #define, do not carry over from an imported header or IDL file to the importing IDL file.

Like the C-language preprocessor macro #include, the import directive tells the compiler to include data types that were defined in the imported IDL files. Unlike the #include directive, the import directive ignores procedure prototypes, since no stubs are generated for anything in the imported file.

For specific information on using import to include header files in an IDL file, see Importing System Header Files.

The C-language header (.H) file generated for the interface does not directly contain the imported types but instead generates a #include directive for the header file corresponding to the imported interface. For example, when you import BASE.IDL into your DERIVED.IDL, the generated header file DERIVED.H will contain the directive #include BASE.H.

The following rules apply:

  • The import keyword is optional and can appear zero or more times in the IDL file.
  • Each import keyword can be associated with more than one file name.
  • Separate multiple file names with commas.
  • You must enclose the file name within quotation marks and end the import statement with a semicolon (;).
  • You can import an interface that has no attributes into another IDL file. However, the interface must contain only datatypes; it cannot contain any procedures. If even one procedure is contained in the imported interface, you must specify a local or UUID attribute.
  • The import function is idempotent — that is, importing an interface more than once has no additional effect.

Note  The behavior of the import directive is independent of the MIDL compiler mode switches /ms_ext (the default), /osf, and /app_config. However, the compiler mode (/osf or /ms_ext) can affect pointer attribute decoration on imported types. For details see Pointer-Attribute Type Inheritance.

Examples

import "myoldodl.odl";  
import "unknwn.idl";
import "part1.idl", "part2.idl", "part3.idl"; 

See also

/app_config
Interface Definition (IDL) File
importlib
include
Importing System Header Files
Importing Files and Type Libraries
/ms_ext
/osf

 

 

Community Additions

ADD
Show:
© 2014 Microsoft