IProgressUI::ShowMessageEx 方法
從 2006 版開始,方法 ShowMessageEx
會顯示可自訂的對話方塊。 這個方法類似于 IProgressUI::ShowMessage 方法,但也包含新的整數結果變數 pResult。
語法
[IDL]
HRESULT ShowMessageEx(
BSTR pszText,
BSTR pszCaption,
ULONG uType,
INT *pResult
);
參數
pszText
資料類型:BSTR
限定詞:[in]
訊息方塊本文中顯示的文字。
pszCaption
資料類型:BSTR
限定詞:[in]
訊息方塊視窗標頭中顯示的文字。
uType
資料類型:ULONG
限定詞:[in]
對應至按鈕下列其中一個可能值的值:
- 0 - 確定
- 1 - 確定/取消
- 2 - 中止/重試/忽略
- 3 - 是/否/取消
- 4 - 是/否
- 5 - 重試/取消
- 6 - 取消/再試一次/繼續
pResult
資料類型:INT
限定詞:[out]
此變數的值是標準 Windows 訊息方塊傳回值。
傳回值
程式 HRESULT
代碼。 可能的值包括但不限於下列值。 這個方法未傳回任何 HRESULT
特定的值。
S_OK
方法成功。
若要評估使用者對訊息方塊的回應,請使用 pResult 參數。
範例
下列 PowerShell 腳本範例示範如何使用此方法:
$Message = "Can you see this message?"
$Title = "Contoso IT"
$Type = 4 # Yes/No
$Output = 0
$TaskSequenceProgressUi = New-Object -ComObject "Microsoft.SMS.TSProgressUI"
$TaskSequenceProgressUi.ShowMessageEx($Message, $Title, $Type, [ref]$Output)
$TSEnv = New-Object -ComObject "Microsoft.SMS.TSEnvironment"
if ($Output -eq 6) {
$TSEnv.Value("TS-UserPressedButton") = 'Yes'
}
您可以在工作順序的 [ 執行 PowerShell 腳本 ] 步驟中使用類似這樣的腳本。 如果使用者在自訂視窗中選取 [是],腳本會建立值為 的 Yes
自訂工作順序變數TS-UserPressedButton。 然後,您可以在其他腳本中使用此工作順序變數,或做為其他工作順序步驟的條件。