literalInclude element

Places a C or IDL include statement in the generated code.

Usage

<literalInclude
  Language = "language string"
  Local = "Boolean"/>

Attributes

Attribute Type Required Description
Language
language string
No
The type of header file to be included.

C
Include a C header file.
IDL
Include an IDL file.
Local
Boolean
No
This attribute is only used when Language is set to "C".

True
Searches the current directory for the named header before searching the system directories.
False
Only search system directories for the named header.

Child elements

There are no child elements.

Parent elements

Element Description
file
Outputs a file from the code generator.

Remarks

The following examples show the code generated from different literalInclude elements.

Example 1 - Generating a C include statement

Input XML:

<literalInclude Language="C" Local="False">wsdapi.h</literalInclude>

Output code:

#include <wsdapi.h>

Example 2 - Generating a C include statement

Input XML:

<literalInclude Language="C" Local="True">wsdapi.h</literalInclude>

Output code:

#include "wsdapi.h"

Example 3 - Generating an IDL import statement

Input XML:

<literalInclude Language="IDL">wsdclient.idl</literalInclude>

Output code:

import wsdclient.idl;

Element information

Label Value
Minimum supported system
Windows Vista
Can be empty Yes