IProgressUI::ShowMessageEx-MethodeIProgressUI::ShowMessageEx method

  • 2 Minuten Lesedauer

Ab Version 2006 wird von der- ShowMessageEx Methode ein anpassbares Dialogfeld angezeigt.Starting in version 2006, the ShowMessageEx method displays a customizable dialog box. Diese Methode ähnelt der iprogressui:: ShowMessage -Methode, umfasst aber auch eine neue ganzzahlige Ergebnisvariable, pResult .This method is similar to the IProgressUI::ShowMessage method, but also includes a new integer result variable, pResult .

SyntaxSyntax

[IDL]  
HRESULT ShowMessageEx(  
     BSTR pszText,  
     BSTR pszCaption,  
     ULONG uType,
     INT *pResult
);

ParameterParameters

pszText

Datentyp: BSTRData type: BSTR

Qualifizierer: [in]Qualifiers: [in]

Der im Meldungs Feld Text angezeigte Text.The text displayed in the message box body.

pszCaption

Datentyp: BSTRData type: BSTR

Qualifizierer: [in]Qualifiers: [in]

Der im Meldungs Feld-Windows-Header angezeigte Text.The text displayed in the message box windows header.

uType

Datentyp: ULONGData type: ULONG

Qualifizierer: [in]Qualifiers: [in]

Der Wert, der einem der folgenden möglichen Werte für die Schaltflächen entspricht:The value corresponding to one of the following possible values for the buttons:

  • 0-OK0 - Ok
  • 1-OK/Abbrechen1 - Ok/Cancel
  • 2-Abbrechen/Wiederholen/ignorieren2 - Abort/Retry/Ignore
  • 3-Ja/Nein/Abbrechen3 - Yes/No/Cancel
  • 4-Ja/Nein4 - Yes/No
  • 5: Wiederholung/Abbruch5 - Retry/Cancel
  • 6-Abbrechen/erneut versuchen/fortfahren6 - Cancel/Try Again/Continue

pResult

Datentyp: INTData type: INT

Qualifizierer: [out]Qualifiers: [out]

Der Wert dieser Variablen ist ein standardmäßiger Rückgabewert des Windows-Meldungsfelds.The value of this variable is a standard Windows message box return value.

RückgabewerteReturn values

Ein- HRESULT Code.An HRESULT code. Mögliche Werte sind u. a. der folgende Wert.Possible values include, but aren't limited to, the following value. Es wurden keine HRESULT Werte zurückgegeben, die für diese Methode spezifisch sind.There are no HRESULT values returned that are specific to this method.

S_OKS_OK
Die Methode wurde erfolgreich ausgeführt.The method succeeded.

Um die Antwort des Benutzers auf das Meldungs Feld auszuwerten, verwenden Sie den pResult -Parameter.To evaluate the user's response to the message box, use the pResult parameter.

BeispielExample

Im folgenden PowerShell-Skriptbeispiel wird die Verwendung dieser Methode veranschaulicht:The following PowerShell script sample shows how to use this method:

$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'
}

Sie können ein Skript wie dieses im Schritt PowerShell-Skript ausführen in der Tasksequenz verwenden.You can use a script like this in the Run PowerShell Script step in the task sequence. Wenn der Benutzer im benutzerdefinierten Fenster Ja auswählt, erstellt das Skript eine benutzerdefinierte Tasksequenzvariable TS-UserPressedButton mit dem Wert Yes.If the user selects Yes in the custom window, the script creates a custom task sequence variable TS-UserPressedButton with a value of Yes. Sie können diese Tasksequenzvariable dann in anderen Skripts oder als Bedingung für andere Tasksequenzschritte verwenden.You can then use this task sequence variable in other scripts or as a condition on other task sequence steps.

Weitere InformationenSee also