在 Configuration Manager 中, 方法會ShowActionProgress在自訂動作執行時,在對話框中顯示自定義動作進度資訊。
語法
[IDL]
HRESULT ShowActionProgress(
BSTR pszOrgName,
BSTR pszTaskSequenceName,
BSTR pszCustomTitle,
BSTR pszCurrentAction,
ULONG uStep,
ULONG uMaxStep,
BSTR pszActionExecInfo,
ULONG uActionExecStep,
ULONG uActionExecMaxStep
);
參數
pszOrgName
資料類型:BSTR
限定符:[in]
進度對話框中顯示的組織名稱指標。 您可以從環境變數擷 _SMSTSOrgName 取值。
pszTaskSequenceName
資料類型:BSTR
限定符:[in]
目前執行中工作順序名稱的指標。 您可以從環境變數擷 _SMSTSPackageName 取值。
pszCustomTitle
資料類型:BSTR
限定符:[in]
自定義訊息的文字指標,該自定義訊息會取代進度對話框中顯示的預設標題文字。 如果沒有要顯示的自訂訊息,請傳遞空字串。 此值可以從 _SMSTSCustomProgressDialogMessage 環境變數取得。
pszCurrentAction
資料類型:BSTR
限定符:[in]
目前工作順序步驟名稱的指標。 此值可以從 _SMSTSCurrentActionName 環境變數取得。
uStep
資料類型:ULONG
限定符:[in]
目前的工作順序步驟編號。 此值可以從 SMSTSNextInstructionPointer 環境變數取得。
uMaxStep
資料類型:ULONG
限定符:[in]
工作順序中的步驟總數。 此值可以從 _SMSTSInstructionTableSize 環境變數取得。
pszActionExecInfo
資料類型:BSTR
限定符:[in]
要在進度對話框中顯示的使用者定義動作特定進度資訊指標。
uActionExecStep
資料類型:ULONG
限定符:[in]
數值步驟,在動作目前運作所在的數值步驟總數內。
使用此參數來判斷到目前為止已完成的動作百分比。 如需詳細資訊,請參閱。
uActionExecMaxStep
資料類型:ULONG
限定符:[in]
動作執行的數值步驟總數。
使用此參數來判斷到目前為止已完成的動作百分比。 如需詳細資訊,請參閱。
傳回值
程序 HRESULT 代碼。 可能的值包括但不限於下列值。 這個方法未傳回任何 HRESULT 特定的值。
S_OK 方法成功。
註解
這個方法的唯一必要資訊是 、 pszActionExecInfouActionExecStep和 uActionExecMaxStep 參數。 其他參數可以從參考的環境變數取得。
的呼叫 ShowActionProgress 應該使用 uActionExecStep 和 uActionExecMaxStep 參數來指定動作完成的百分比。 例如,如果 uActionExecStep 指定值 2 並 uActionExecMaxStep 指定值 10,則動作完成百分比為 20%。