類別 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) 選擇性地與匯入開機映像時的狀態相關聯。 此識別碼由 SMS_BootImagePackage Server WMI 類別的內容指出ContextID。

Status 資料類型： UInt32

資格賽：[出局]

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

值 狀態
0 已完成
1 進行中。
2 錯誤
3 無狀態

Progress 資料類型： UInt32

資格賽：[出局]

進度狀態，指出二進位注入作業中目前步驟的數目。

MaxProgress 資料類型： UInt32

資格賽：[出局]

二進位注入作業中的步驟總數。

ProgressText 資料類型： String

資格賽：[出局]

使用者可讀的字串，用於識別二進位注入作業目前的進度。

ErrorCode 資料類型： SInt32

資格賽：[出局]

二進位注入作業發生錯誤時的 32 位元錯誤碼。 錯誤碼的範例是 FILE_NOT_FOUND (2) 。 記錄檔包含錯誤碼詳細資料。

ExtendedErrorInfo 資料類型： String

資格賽：[出局]

如果參數設定為錯誤碼，則 ErrorCode 為其他錯誤資訊。 目前，如果二進位注入作業無法插入特定驅動程式的二進位檔，此參數會用來報告驅動程式檔案資訊。

傳回值

SInt32資料類型為 0 表示成功，非零表示失敗。

如需處理傳回錯誤的相關資訊，請參閱 關於 Configuration Manager 錯誤。

註解

若要使用此 QueryOSDBinaryInjectionStatus 方法，您的應用程式必須：

  1. 建立與簡訊提供者的連線。 如需詳細資訊，請參閱 SMS 提供者基礎。

  2. 存取 SMS_BootImagePackage Server WMI 類別 物件。

  3. 在類別 SMS_BootImagePackage 中呼叫 ExportDefaultBootImage 方法。

  4. 然後視需要呼叫 QueryOSDBinaryInjectionStatus 以找出二進位注入作業的狀態。

  5. 使用 和 ProgressMaxProgress 參數的值來判斷二進位注入作業的完成百分比狀態。

需求

執行階段需求

如需詳細資訊，請參閱 Configuration Manager 伺服器執行階段需求。

開發需求

如需詳細資訊，請參閱 Configuration Manager 伺服器開發需求。

另請參閱

SMS_BootImagePackage Server WMI類別 SMS_BootImagePackage 中的 ExportDefaultBootImage 方法

  • 上次更新時間：