共用方式為


IProgressUI::ShowActionProgress 方法

在 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 方法成功。

註解

這個方法的唯一必要資訊是 、 pszActionExecInfouActionExecStepuActionExecMaxStep 參數。 其他參數可以從參考的環境變數取得。

的呼叫 ShowActionProgress 應該使用 uActionExecStepuActionExecMaxStep 參數來指定動作完成的百分比。 例如,如果 uActionExecStep 指定值 2 並 uActionExecMaxStep 指定值 10,則動作完成百分比為 20%。

另請參閱