CreateFromINFs Method in Class SMS_Driver

Article
10/04/2022

The CreateFromINFs Windows Management Instrumentation (WMI) class method, in Configuration Manager, creates SMS_Driver Server WMI Class objects based on information from the specified source path and one or more Microsoft Windows .inf files.

The following syntax is simplified from Managed Object Format (MOF) code and defines the method.

Syntax

sint32 CreateFromINFs (  
    String DriverPath,   
    String INFFiles[],   
    SMS_Driver Drivers[]  
);

Parameters

DriverPath
Data type: String

Qualifiers: [in]

Valid Universal Naming Convention (UNC) network path to the folder that contains the driver contents. For example, \\Servers\Driver\VideoDriver.

INFFiles
Data type: String Array

Qualifiers: [in]

The names of the INF files.

Drivers
Data type: SMS_Driver Array

Qualifiers: [out]

An array of SMS_Driver Server WMI Class objects with a complete driver catalog.

Return Values

An SInt32 data type that is 0 to indicate success or nonzero to indicate failure. The error values are available in the SMS_ExtendedStatus Server WMI Class error object. For information about handling returned errors, see About Configuration Manager Errors.

Possible error values include, but aren't limited to, the following:

0
Success

13
The driver is invalid

1633
The driver is valid but doesn't support any platforms supported by Configuration Manager.

2
The SMS Provider can't access the network share.

183
The driver has already been imported.

To find out specifics of an error, see the OSDDriverCatalog.log file.

Remarks

A driver is represented by an information file (INF). The INF file is a text file that specifies the files that need to be present or downloaded for the operating system to run. The information in this type of file provides installation instructions that the Internet Component Download service provided in Microsoft Internet Explorer 3.0 or later uses to install and register software components that are downloaded from the Internet, in addition to any files required by the components.

Note

Your application should create a driver only by calling this method or the CreateFromOEM Method in Class SMS_Driver. It should never create a driver directly.

This method creates a new SMS_Driver Server WMI Class object.

Once created, the SMS_Driver Server WMI ClassSDMPackageXML contains the driver definition XML. To set the display information used by the Configuration Manager console for the driver, you need to set the localization information in the SMS_Driver Server WMI ClassLocalizedInformation property. The driver name used by the display from is available in SMS_Driver Server WMI ClassSDMPackageXML property XML. For more information, see How to Import a Windows Driver Described by an INF File into Configuration Manager.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

Share via