Freigeben über

QueryOSDBinaryInjectionStatus-Methode in class SMS_BootImagePackage

  • Artikel

Die QueryOSDBinaryInjectionStatus WMI-Klassenmethode (Windows Management Instrumentation) fragt in Configuration Manager den aktuellen status der Einschleusung von Binärdateien der Betriebssystembereitstellung in ein Startimage ab.

Die folgende Syntax wird von MOF-Code (Managed Object Format) 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

Qualifizierer: [in]

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

Status
Datentyp: UInt32

Qualifizierer: [out]

Die aktuelle status der Binäreinjektion. Die folgenden Werte sind möglich:

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

Progress
Datentyp: UInt32

Qualifizierer: [out]

Der Fortschritt status, der die Nummer des aktuellen Schritts im binären Einschleusungsvorgang angibt.

MaxProgress
Datentyp: UInt32

Qualifizierer: [out]

Die Gesamtanzahl der Schritte im Binäreinjektionsvorgang.

ProgressText
Datentyp: String

Qualifizierer: [out]

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

ErrorCode
Datentyp: SInt32

Qualifizierer: [out]

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

ExtendedErrorInfo
Datentyp: String

Qualifizierer: [out]

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

Rückgabewerte

Ein SInt32 Datentyp, der 0 ist, um einen Erfolg anzugeben, oder ungleich 0 (null), um einen Fehler anzugeben.

Informationen zur Behandlung von zurückgegebenen Fehlern 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 des SMS_BootImagePackage-Servers zu.

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

  4. Rufen Sie QueryOSDBinaryInjectionStatus dann bei Bedarf auf, um die status des binären Einschleusungsvorgangs zu ermitteln.

  5. Verwenden Sie die Werte der Progress Parameter und MaxProgress , um den prozentsatz abgeschlossenen status des Binäreinjektionsvorgangs zu bestimmen.

Anforderungen

Laufzeitanforderungen

Weitere Informationen finden Sie unter anforderungen an Configuration Manager Server Runtime.

Entwicklungsanforderungen

Weitere Informationen finden Sie unter Configuration Manager Serverentwicklungsanforderungen.

Siehe auch

WMI-Klasse für SMS_BootImagePackage Server
ExportDefaultBootImage-Methode in Class SMS_BootImagePackage