共用方式為

類別SMS_BootImagePackage中的 QueryOSDBinaryInjectionStatus 方法

  • 發行項

Windows QueryOSDBinaryInjectionStatus Management Instrumentation (WMI) 類別方法，Configuration Manager會查詢將作業系統部署二進位檔插入開機映射的目前狀態。

下列語法是從受控物件格式 (MOF) 程式碼中簡化，並定義 方法。

語法

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

參數

ContextID
資料類型：String

限定詞：[in]

內容 (索引的識別碼) 選擇性地與開機映射匯入時的狀態相關聯。 此識別碼是以 ContextIDSMS_BootImagePackage Server WMI 類別的 屬性工作表示。

Status
資料類型：UInt32

限定詞：[out]

二進位插入的目前狀態。 可能的值為：

值 狀態
0 已完成
1 進行中。
2 錯誤
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 方法