INF File Processing Functions

The INF file processing functions provide setup and installation functionality that includes the following:

  • Opening and closing an INF file.

  • Retrieving information about an INF file.

  • Retrieving information about source files and target directories for copy operations.

  • Performing the installation actions specified in an INF file section.

The following table lists the functions that are used for processing INF files. For detailed function descriptions, see the Microsoft Windows SDK documentation.

Function Description

InstallHinfSection

Executes a specified section in a specified INF file.

SetupCloseInfFile

Frees resources and closes the INF handle.

SetupCopyOEMInf

Stages a driver package in the Driver Store.

SetupDecompressOrCopyFile

Copies a file and, if necessary, decompresses it.

SetupFindFirstLine

Finds a pointer to the first line in a section of an INF file or, if a key is specified, the first line that matches the key.

SetupFindNextLine

Returns a pointer to the next line in an INF file section.

SetupFindNextMatchLine

Returns a pointer to the next line in an INF file section or, if a key is specified, the next line that matches the key.

SetupGetBinaryField

Retrieves binary data from a field in a specified line, in an INF file.

SetupGetFieldCount

Returns the number of fields in a line.

SetupGetFileCompressionInfo

Retrieves file compression information from an INF file.

SetupGetInfDriverStoreLocation

Retrieves the fully qualified file name (directory path and file name) of an INF file in the Driver Store that corresponds to a specified INF file in the system INF file directory or a specified INF file in the driver store.

SetupGetInfFileList

Returns a list of the INF files in a specified directory.

SetupGetInfInformation

Returns information about an INF file.

SetupGetIntField

Obtains the integer value of a specified field in a specified line, in an INF file.

SetupGetInfPublishedName

Retrieves the fully qualified name (directory path and file name) of an INF file in the system INF file directory that corresponds to a specified INF file in the system INF file directory or a specified INF file in the Driver Store.

SetupGetLineByIndex

Returns a pointer to the line associated with a specified index value in a specified section.

SetupGetLineCount

Returns the number of lines in the specified section.

SetupGetLineText

Retrieves the contents of a specified line from an INF file.

SetupGetMultiSzField

Returns multiple strings, starting at a specified field in a line.

SetupGetSourceFileLocation

Returns the location of a source file that is listed in an INF file.

SetupGetSourceFileSize

Returns the size of a specified file or a set of files that are listed in a specified section of an INF file.

SetupGetSourceInfo

Retrieves the path, tag file, or description for a source.

SetupGetStringField

Retrieves string data from a field in a specified line, in an INF file.

SetupGetTargetPath

Determines the target path for the files that are listed in a specified INF file section.

SetupInstallFile

Installs a specified file into a specific target directory.

SetupInstallFileEx

Installs a specified file into a specific target directory. The installation is postponed if an existing version of the file is in use.

SetupInstallFilesFromInfSection

Queues the files in a specified INF file section for copying. (Same as SetupQueueCopySection.)

SetupInstallFromInfSection

Performs the directives specified in an INF DDInstall section.

SetupInstallServicesFromInfSection

Performs service installation and deletion operations as specified in an INF DDInstall.Services section.

SetupOpenAppendInfFile

Opens an INF file and appends it to an existing INF handle.

SetupOpenInfFile

Opens an INF file and returns a handle to it.

SetupOpenMasterInf

Opens the master INF file that contains file and layout information for files that were included with the default installation of the operating system.

SetupQueryInfFileInformation

Returns the name of one of the constituent INF files of a specified INF file.

SetupQueryInfVersionInformation

Returns the version number of one of the constituent INF files of a specified INF file.

SetupSetDirectoryId

Assigns a directory ID (DIRID) to a specified directory.

SetupUninstallOEMInf

Uninstalls a specified INF file, and deletes the associated .pnf and .cat files, if they exist.

SetupVerifyInfFile

Verifies that a digitally-signed INF file has not been modified. (Windows XP and later.)