Methode QueryOSDBinaryInjectionStatus in klasse SMS_BootImagePackage
De QueryOSDBinaryInjectionStatus
WMI-klassemethode (Windows Management Instrumentation) in Configuration Manager voert een query uit op de huidige status van de injectie van binaire besturingssysteemimplementatiebestanden in een opstartinstallatiekopie.
De volgende syntaxis is vereenvoudigd van MOF-code (Managed Object Format) en definieert de methode.
Syntaxis
SInt32 QueryOSDBinaryInjectionStatus(
String ContextID,
UInt32 Status,
UInt32 Progress,
UInt32 MaxProgress,
String ProgressText,
SInt32 ErrorCode,
String ExtendedErrorInfo
);
Parameters
ContextID
Gegevenstype: String
Kwalificatie: [in]
De id van de context (index) die optioneel is gekoppeld aan de status bij het importeren van een opstartinstallatiekopie. Deze id wordt aangegeven door de ContextID
eigenschap van WMI-klasse SMS_BootImagePackage-server.
Status
Gegevenstype: UInt32
Kwalificatie: [uit]
De huidige status van binaire injectie. Mogelijke waarden zijn:
Waarde | Status |
---|---|
0 | Volledige |
1 | Wordt uitgevoerd |
2 | Error |
3 | Geen status |
Progress
Gegevenstype: UInt32
Kwalificatie: [uit]
De voortgangsstatus die het nummer van de huidige stap in de binaire injectiebewerking aangeeft.
MaxProgress
Gegevenstype: UInt32
Kwalificatie: [uit]
Het totale aantal stappen in de binaire injectiebewerking.
ProgressText
Gegevenstype: String
Kwalificatie: [uit]
Een door de gebruiker leesbare tekenreeks die de huidige voortgang van de binaire injectiebewerking aangeeft.
ErrorCode
Gegevenstype: SInt32
Kwalificatie: [uit]
Een 32-bits foutcode in het geval van een fout in de binaire injectiebewerking. Een voorbeeld van een foutcode is FILE_NOT_FOUND (2). Het logboekbestand bevat foutcodedetails.
ExtendedErrorInfo
Gegevenstype: String
Kwalificatie: [uit]
Aanvullende foutinformatie als de ErrorCode
parameter is ingesteld op een foutcode. Deze parameter wordt momenteel gebruikt om informatie over stuurprogrammabestanden te rapporteren als de binaire injectiebewerking de binaire bestanden voor een bepaald stuurprogramma niet kan injecteren.
Retourwaarden
Een SInt32
gegevenstype dat 0 is om aan te geven dat het is geslaagd of niet nul om een fout aan te geven.
Zie Over Configuration Manager-fouten voor informatie over het verwerken van geretourneerde fouten.
Opmerkingen
Als u de QueryOSDBinaryInjectionStatus
methode wilt gebruiken, moet uw toepassing het volgende doen:
Maak een verbinding met de SMS-provider. Zie Basisprincipes van SMS-provider voor meer informatie.
Open het WMI-klasseobject SMS_BootImagePackage Server .
Roep de methode ExportDefaultBootImage aan in klasse SMS_BootImagePackage.
QueryOSDBinaryInjectionStatus
Roep vervolgens zo nodig aan om de status van de binaire injectiebewerking te bepalen.Gebruik de waarden van de
Progress
parameters enMaxProgress
om het percentage voltooide status van de binaire injectiebewerking te bepalen.
Vereisten
Runtimevereisten
Zie runtimevereisten voor Configuration Manager server voor meer informatie.
Ontwikkelingsvereisten
Zie vereisten voor Configuration Manager serverontwikkeling voor meer informatie.
Zie ook
WMI-klasse SMS_BootImagePackage-server
Methode ExportDefaultBootImage in klasse SMS_BootImagePackage