通过

类SMS_BootImagePackage中的 QueryOSDBinaryInjectionStatus 方法

  • 项目

QueryOSDBinaryInjectionStatus在 Configuration Manager 中，Windows Management Instrumentation (WMI) 类方法查询操作系统部署二进制文件注入启动映像的当前状态。

以下语法从托管对象格式 (MOF) 代码中简化，并定义了 方法。

语法

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

参数

ContextID
数据类型String

限定符：[in]

上下文 (索引的 ID) （可选）与导入启动映像时的状态相关联。 此 ID 由 ContextIDSMS_BootImagePackage 服务器 WMI 类的 属性指示。

Status
数据类型UInt32

限定符：[out]

二进制注入的当前状态。 可能的值是：

值 状态
0 完成
1 正在进行
2 Error
3 无状态

Progress
数据类型UInt32

限定符：[out]

指示二进制注入操作中当前步骤数的进度状态。

MaxProgress
数据类型UInt32

限定符：[out]

二进制注入操作中的步骤总数。

ProgressText
数据类型String

限定符：[out]

一个用户可读字符串，标识二进制注入操作的当前进度。

ErrorCode
数据类型SInt32

限定符：[out]

二进制注入操作出错时为 32 位错误代码。 错误代码的一个示例是 FILE_NOT_FOUND (2) 。 日志文件包含错误代码详细信息。

ExtendedErrorInfo
数据类型String

限定符：[out]

如果参数设置为错误代码， ErrorCode 则提供其他错误信息。 目前，如果二进制注入操作无法为特定驱动程序注入二进制文件，则此参数用于报告驱动程序文件信息。

返回值

一个 SInt32 数据类型，为 0 表示成功，非零表示失败。

有关处理返回的错误的信息，请参阅关于Configuration Manager错误。

备注

若要使用 QueryOSDBinaryInjectionStatus 方法，应用程序必须：

  1. 建立与 SMS 提供程序的连接。 有关详细信息，请参阅 SMS 提供程序基础知识。

  2. 访问 SMS_BootImagePackage 服务器 WMI 类 对象。

  3. 在 类SMS_BootImagePackage中调用 ExportDefaultBootImage 方法。

  4. 然后根据需要调用 QueryOSDBinaryInjectionStatus 以找出二进制注入操作的状态。

  5. 使用 和 MaxProgress 参数的值Progress来确定二进制注入操作的完成百分比状态。

要求

运行时要求

有关详细信息，请参阅Configuration Manager服务器运行时要求。

开发要求

有关详细信息，请参阅Configuration Manager服务器开发要求。

另请参阅

SMS_BootImagePackage服务器 WMI 类
类SMS_BootImagePackage中的 ExportDefaultBootImage 方法