Edit

Share via

literalInclude element

  • Article

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