CreateFromINF Method in Class SMS_Driver

Article
05/03/2011

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

The CreateFromINF Windows Management Instrumentation (WMI) class method, in Configuration Manager, creates an SMS_Driver Server WMI Class object based on information from the specified Microsoft Windows INF file.

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

SInt32 CreateFromINF(
      String DriverPath,
      String INFFile,
      SMS_Driver Driver
);

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.

INFFile
Data type: String

Qualifiers: [in]

The name of the INF file.

Driver
Data type: SMS_Driver

Qualifiers: [out]

An SMS_Driver Server WMI Class object with a complete driver catalog.

Return Values

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

Possible error values include, but are not limited to, the following:

0
Success

13
The driver is invalid

1633
The driver is valid but does not support any platforms supported by Configuration Manager.

2
The SMS Provider cannot 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, SMS_Driver Server WMI ClassSDMPackageXML contains the driver definition XML. To set the display information used by the Configuration Manager 2007 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.