Méthode QueryOSDBinaryInjectionStatus en classe SMS_BootImagePackage

La QueryOSDBinaryInjectionStatus méthode de classe WMI (Windows Management Instrumentation), en Configuration Manager, interroge le status actuel de l’injection de binaires de déploiement de 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

Qualificatifs : [dans]

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

Status Type de données : UInt32

Qualifications : [out]

Le status actuel de l’injection binaire. Les valeurs possibles sont les suivantes :

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

Progress Type de données : UInt32

Qualifications : [out]

Le status de progression indiquant le numéro de l’étape en cours dans l’opération d’injection binaire.

MaxProgress Type de données : UInt32

Qualifications : [out]

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

ProgressText Type de données : String

Qualifications : [out]

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

ErrorCode Type de données : SInt32

Qualifications : [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

Qualifications : [out]

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

Valeurs de retour

Type de SInt32 données égal à 0 pour indiquer un succès ou à une valeur non nulle pour indiquer un échec.

Pour plus d’informations sur le traitement des erreurs retournées, consultez À propos des erreurs de Configuration Manager.

Remarques

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

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

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

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

  4. Appelez QueryOSDBinaryInjectionStatus ensuite en fonction des besoins 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’achèvement status de l’opération d’injection binaire.

Configuration requise

Configuration requise pour l’exécution

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

Configuration requise pour le développement

Pour plus d’informations, consultez Configuration requise pour le développement du serveur Configuration Manager.

Voir aussi

SMS_BootImagePackage Server WMI classeExportDefaultBootImage méthode dans la classe SMS_BootImagePackage