Metodo CreateFromOEM nella classe SMS_Driver

Il CreateFromOEM metodo della classe Strumentazione gestione Windows (WMI), in Configuration Manager, crea un set di oggetti della classe WMI del server SMS_Driver di archiviazione di massa a cui fa riferimento il file Txtsetup.oem specificato.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e definisce il metodo.

Sintassi

SInt32 CreateFromOEM(
      String DriverPath,
      String OEMFile,
      SMS_Driver Drivers[]
);

Parametri

DriverPath Tipo: String

Qualificazioni: [in]

Percorso UNC (Universal Naming Convention) contenente il contenuto del driver.

OEMFile Tipo: String

Qualificazioni: [in]

Percorso relativo del file Txtsetup.oem.

Drivers Tipo: SMS_Driver Array

Qualificazioni: [fuori]

Matrice di driver con catalogo completo di driver.

Valori restituiti

Tipo SInt32 di dati pari a 0 per indicare l'esito positivo o diverso da zero per indicare l'errore. I valori di errore sono disponibili nell'oggetto errore della classe WMI del server SMS_ExtendedStatus . Per informazioni sulla gestione degli errori restituiti, vedere Informazioni sugli errori di Configuration Manager.

Questo metodo restituisce esito positivo se almeno uno dei file a cui fa riferimento il file Txtsetup.oem è valido.

I possibili valori di errore includono, a titolo esemplificativo:

0 Operazione riuscita

13 Il file Txtsetup.oem non è valido.

Tutti i driver a cui fa riferimento il file Txtsetup.oem non sono validi.

2 Il provider SMS non può accedere al file Txtsetup.oem.

1633 Tutti i driver a cui fa riferimento il file Txtsetup.oem sono validi ma non supportano alcuna piattaforma supportata da Configuration Manager.

183 Tutti i driver a cui fa riferimento il file Txtsetup.oem sono già stati importati.

Tutti i driver a cui fa riferimento il file Txtsetup.oem presentano un altro tipo di errore. Per ulteriori informazioni, vedere il file OSDDriverCatalog.log nel computer del provider.

Osservazioni

Per supportare le distribuzioni del sistema operativo precedenti a Windows Vista, Configuration Manager utilizza driver di dispositivo di archiviazione di massa critici per l'avvio. Questo tipo di driver viene fornito sotto forma di file Txtsetup.oem fornito su un disco. Il file contiene le informazioni seguenti:

  • Componenti hardware supportati dal file

  • Files da copiare dal disco di distribuzione per ogni componente

  • Chiavi del Registro di sistema e valori da creare per ogni componente

    Un file di driver del dispositivo di archiviazione di massa deve essere installato prima dell'installazione in una distribuzione del sistema operativo precedente a Windows Vista.

Nota

L'applicazione deve creare un driver solo chiamando questo metodo o il metodo CreateFromINF nella classe SMS_Driver. Non dovrebbe mai creare direttamente un driver.

L'applicazione chiama questo metodo con un file Txtsetup.oem del driver e un percorso del file. Il metodo esamina le informazioni fornite e crea una matrice di nuovi oggetti SMS_Driver Server WMI Class, uno per ogni file con estensione inf a cui si fa riferimento.

Questo metodo genera SMS_Driver oggetti di classe WMI del server con XML del pacchetto SDM (System Definition Model) definito e consente all'applicazione di apportare modifiche alle proprietà prima che vengano salvate.

Requisiti

Requisiti di runtime

Per altre informazioni, vedere Configuration Manager Requisiti di runtime del server.

Requisiti di sviluppo

Per altre informazioni, vedere Requisiti di sviluppo del server di Configuration Manager.

Vedere anche

Classe WMI del server SMS_Driver