Partager via


Méthode QueryOSDBinaryInjectionStatus dans la classe SMS_BootImagePackage

La QueryOSDBinaryInjectionStatus méthode de classe WMI (Windows Management Instrumentation), dans Configuration Manager, interroge la status actuelle 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ées: String

Qualificateurs : [in]

ID du contexte (index) associé éventuellement à l’status 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ées: UInt32

Qualificateurs : [out]

Status actuelle 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ées: UInt32

Qualificateurs : [out]

La progression status indiquant le numéro de l’étape actuelle dans l’opération d’injection binaire.

MaxProgress Type de données: UInt32

Qualificateurs : [out]

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

ProgressText Type de données: String

Qualificateurs : [out]

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

ErrorCode Type de données: SInt32

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ées: String

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 le status de l’opération d’injection binaire.

  5. Utilisez les valeurs des Progress paramètres et MaxProgress pour déterminer le pourcentage d’status 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

Méthode ExportDefaultBootImage de la classe WMI SMS_BootImagePackage Server dans la classe SMS_BootImagePackage