CreateFromINFs Method in Class SMS_Driver
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.