クラス SMS_BootImagePackage の QueryOSDBinaryInjectionStatus メソッド

Configuration Manager のQueryOSDBinaryInjectionStatus Windows Management Instrumentation (WMI) クラス メソッドは、ブート イメージへのオペレーティング システム展開バイナリの挿入の現在の状態を照会します。

次の構文は、マネージ オブジェクト形式 (MOF) コードから簡素化され、メソッドを定義したものです。

構文

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

パラメーター

ContextID データ型: String

Qualifiers: [in]

ブート イメージのインポート時の状態に関連付けられるコンテキストの ID (インデックス)。 この ID は、サーバー WMI クラスSMS_BootImagePackageContextID プロパティで示されます。

Status データ型: UInt32

Qualifiers: [out]

バイナリ インジェクションの現在の状態。 使用可能な値は次のとおりです。

Progress データ型: UInt32

Qualifiers: [out]

バイナリ インジェクション操作の現在のステップの番号を示す進行状況状態。

MaxProgress データ型: UInt32

Qualifiers: [out]

バイナリ インジェクション操作のステップの合計数。

ProgressText データ型: String

Qualifiers: [out]

バイナリ インジェクション操作の現在の進行状況を示す、ユーザーが判読できる文字列。

ErrorCode データ型: SInt32

Qualifiers: [out]

バイナリ インジェクション操作でエラーが発生した場合の 32 ビットのエラー コード。 エラー コードの例は、FILE_NOT_FOUND (2) です。 ログ ファイルには、エラー コードの詳細が含まれています。

ExtendedErrorInfo データ型: String

Qualifiers: [out]

ErrorCode パラメーターがエラー コードに設定されている場合の追加のエラー情報。 現在、このパラメーターは、バイナリ インジェクション操作で特定のドライバーのバイナリの挿入に失敗した場合に、ドライバー ファイル情報を報告するために使用されます。

戻り値

成功を示す 0 または失敗を示す場合は 0 以外の SInt32 データ型。

返されたエラーの処理の詳細については、「Configuration Manager のエラーについて」を参照してください。

注釈

QueryOSDBinaryInjectionStatus メソッドを使用するには、アプリケーションで次の条件を満たす必要があります。

1. SMS プロバイダーへの接続を確立します。 詳細については、「 SMS プロバイダーの基礎」を参照してください。

2. SMS_BootImagePackage サーバー WMI クラス オブジェクトにアクセスします。

3. クラス SMS_BootImagePackage で ExportDefaultBootImage メソッドを呼び出します。

4. 次に、必要に応じて QueryOSDBinaryInjectionStatus を呼び出して、バイナリ インジェクション操作の状態を確認します。

5. Progress パラメーターと MaxProgress パラメーターの値を使用して、バイナリ インジェクション操作の完了率の状態を判断します。

要件

ランタイム要件

詳細については、「Configuration Manager サーバー ランタイム要件」を参照してください。

開発要件

詳細については、「Configuration Manager サーバー開発の要件」を参照してください。

関連項目

クラス SMS_BootImagePackage のサーバー WMI クラスExportDefaultBootImage メソッドSMS_BootImagePackage