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。 然後，您可以在其他腳本中使用此工作順序變數，或做為其他工作順序步驟的條件。

另請參閱