Partager via

Méthode QueryOSDBinaryInjectionStatus dans la classe SMS_BootImagePackage

  • Article

La QueryOSDBinaryInjectionStatus méthode de classe WMI (Windows Management Instrumentation), dans Configuration Manager, interroge l’état actuel de l’injection de fichiers binaires de déploiement du système d’exploitation dans une image de démarrage.

La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format) et définit la méthode .

Syntaxe

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

Paramètres

ContextID
Type de donnéesString

Qualificateurs : [in]

ID du contexte (index) associé éventuellement à l’état lors de l’importation d’une image de démarrage. Cet ID est indiqué par la ContextID propriété de la classe WMI SMS_BootImagePackage Server.

Status
Type de donnéesUInt32

Qualificateurs : [out]

État actuel de l’injection binaire. Les valeurs possibles sont les suivantes :

Valeur État
0 Exécuter
1 En cours
2 Error
3 Aucun état

Progress
Type de donnéesUInt32

Qualificateurs : [out]

État de progression indiquant le nombre de l’étape actuelle dans l’opération d’injection binaire.

MaxProgress
Type de donnéesUInt32

Qualificateurs : [out]

Nombre total d’étapes dans l’opération d’injection binaire.

ProgressText
Type de donnéesString

Qualificateurs : [out]

Chaîne lisible par l’utilisateur identifiant la progression actuelle de l’opération d’injection binaire.

ErrorCode
Type de donnéesSInt32

Qualificateurs : [out]

Code d’erreur 32 bits en cas d’erreur dans l’opération d’injection binaire. Un exemple de code d’erreur est FILE_NOT_FOUND (2). Le fichier journal contient les détails du code d’erreur.

ExtendedErrorInfo
Type de donnéesString

Qualificateurs : [out]

Informations d’erreur supplémentaires si le ErrorCode paramètre est défini sur un code d’erreur. Actuellement, ce paramètre est utilisé pour signaler les informations du fichier de pilote si l’opération d’injection binaire ne parvient pas à injecter les fichiers binaires pour un pilote particulier.

Valeurs de retour

Type SInt32 de données égal à 0 pour indiquer la réussite ou non zéro pour indiquer l’échec.

Pour plus d’informations sur la gestion des erreurs retournées, consultez À propos des erreurs Configuration Manager.

Remarques

Pour utiliser la QueryOSDBinaryInjectionStatus méthode , votre application doit :

  1. Établissez une connexion au fournisseur SMS. Pour plus d’informations, consultez Notions de base du fournisseur SMS.

  2. Accédez à l’objet WMI Class SMS_BootImagePackage Server .

  3. Appelez la méthode ExportDefaultBootImage dans la classe SMS_BootImagePackage.

  4. QueryOSDBinaryInjectionStatus Appelez ensuite si nécessaire pour connaître l’état de l’opération d’injection binaire.

  5. Utilisez les valeurs des Progress paramètres et MaxProgress pour déterminer le pourcentage d’état complet de l’opération d’injection binaire.

Configuration requise

Configuration requise pour l’exécution

Pour plus d’informations, consultez Configuration Manager Server Runtime Requirements.

Conditions requises pour le développement

Pour plus d’informations, consultez Configuration Manager Server Development Requirements.

Voir aussi

Classe WMI du serveur SMS_BootImagePackage
Méthode ExportDefaultBootImage dans la classe SMS_BootImagePackage