QueryOSDBinaryInjectionStatus-Methode in Klasse SMS_BootImagePackage

Die QueryOSDBinaryInjectionStatus Klassenmethode Windows-Verwaltungsinstrumentation (WMI) im Configuration Manager fragt den aktuellen Status der Einschleusung von Binärdateien für die Betriebssystembereitstellung in ein Startimage ab.

Die folgende Syntax wurde aus Managed Object Format (MOF)-Code vereinfacht und definiert die Methode.

Syntax

SInt32 QueryOSDBinaryInjectionStatus(
     String ContextID,
     UInt32 Status,
     UInt32 Progress,
     UInt32 MaxProgress,
     String ProgressText,
     SInt32 ErrorCode,
     String ExtendedErrorInfo
);

Parameter

ContextID Datentyp: String

Qualifikanten: [in]

Die ID des Kontexts (Index), der optional dem Status beim Import eines Startimages zugeordnet ist. Diese ID wird durch die ContextID Eigenschaft SMS_BootImagePackage Server WMI-Klasse angegeben.

Status Datentyp: UInt32

Qualifikanten: [raus]

Der aktuelle Status der binären Einschleusung. Die folgenden Werte sind möglich:

Wert Status
0 Abschließen
1 In Arbeit
2 Fehler
3 Kein Status

Progress Datentyp: UInt32

Qualifikanten: [raus]

Der Status status die Nummer des aktuellen Schritts im binären Einschleusungsvorgang an.

MaxProgress Datentyp: UInt32

Qualifikanten: [raus]

Die Gesamtanzahl der Schritte im binären Einschleusungsvorgang.

ProgressText Datentyp: String

Qualifikanten: [raus]

Eine vom Benutzer lesbare Zeichenfolge, die den aktuellen Fortschritt des binären Einschleusungsvorgangs angibt.

ErrorCode Datentyp: SInt32

Qualifikanten: [raus]

Ein 32-Bit-Fehlercode im Falle eines Fehlers im binären Einschleusungsvorgang. Ein Beispiel für einen Fehlercode ist FILE_NOT_FOUND (2). Die Protokolldatei enthält Fehlercodedetails.

ExtendedErrorInfo Datentyp: String

Qualifikanten: [raus]

Zusätzliche Fehlerinformationen, wenn der ErrorCode Parameter auf einen Fehlercode gesetzt ist. Derzeit wird dieser Parameter verwendet, um Treiberdateiinformationen zu melden, wenn die Binärinjektion die Binärdateien für einen bestimmten Treiber nicht einschleusen kann.

Rückgabewerte

Ein SInt32 Datentyp, der 0 ist, um Erfolg anzuzeigen, oder ungleich null, um Fehler anzuzeigen.

Informationen zum Behandeln zurückgegebener Fehler finden Sie unter Informationen zu Configuration Manager-Fehlern.

Hinweise

Um die QueryOSDBinaryInjectionStatus Methode verwenden zu können, muss Ihre Anwendung:

  1. Stellen Sie eine Verbindung mit dem SMS-Anbieter her. Weitere Informationen finden Sie unter Grundlagen des SMS-Anbieters.

  2. Greifen Sie auf das WMI-Klassenobjekt SMS_BootImagePackage Server zu.

  3. Rufen Sie die ExportDefaultBootImage-Methode in Klasse SMS_BootImagePackage auf.

  4. Rufen Sie QueryOSDBinaryInjectionStatus dann nach Bedarf an, um den Status des binären Einschleusungsvorgangs zu ermitteln.

  5. Verwenden Sie die Werte der Progress Parameter undMaxProgress, um den prozentualen abgeschlossenen Status des binären Einschleusungsvorgangs zu bestimmen.

Anforderungen

Laufzeitanforderungen

Weitere Informationen finden Sie unter Anforderungen an die Configuration Manager Server-Laufzeit.

Entwicklungsanforderungen

Weitere Informationen finden Sie unter Entwicklungsanforderungen für Configuration Manager Server.

Siehe auch

SMS_BootImagePackage Server WMI ClassExportDefaultBootImage-Methode in Class SMS_BootImagePackage

  • Last updated on