共用方式為

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

註解

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

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

另請參閱