Méthode IProgressUI::ShowMessageEx
À compter de la version 2006, la ShowMessageEx
méthode affiche une boîte de dialogue personnalisable. Cette méthode est similaire à la méthode IProgressUI::ShowMessage , mais inclut également une nouvelle variable de résultat d’entier, pResult.
Syntaxe
[IDL]
HRESULT ShowMessageEx(
BSTR pszText,
BSTR pszCaption,
ULONG uType,
INT *pResult
);
Paramètres
pszText
Type de donnéesBSTR
Qualificateurs : [in]
Texte affiché dans le corps de la boîte de message.
pszCaption
Type de donnéesBSTR
Qualificateurs : [in]
Texte affiché dans l’en-tête des fenêtres de boîte de message.
uType
Type de donnéesULONG
Qualificateurs : [in]
Valeur correspondant à l’une des valeurs possibles suivantes pour les boutons :
- 0 - Ok
- 1 - Ok/Annuler
- 2 - Abandonner/réessayer/Ignorer
- 3 - Oui/Non/Annuler
- 4 - Oui/Non
- 5 - Réessayer/Annuler
- 6 - Annuler/Réessayer/Continuer
pResult
Type de donnéesINT
Qualificateurs : [out]
La valeur de cette variable est une valeur de retour de boîte de message Windows standard.
Valeurs de retour
Code HRESULT
. Les valeurs possibles incluent, sans s’y limiter, la valeur suivante. Aucune valeur retournée n’est HRESULT
spécifique à cette méthode.
S_OK
La méthode a réussi.
Pour évaluer la réponse de l’utilisateur à la boîte de message, utilisez le paramètre pResult .
Exemple
L’exemple de script PowerShell suivant montre comment utiliser cette méthode :
$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'
}
Vous pouvez utiliser un script comme celui-ci à l’étape Exécuter le script PowerShell de la séquence de tâches. Si l’utilisateur sélectionne Oui dans la fenêtre personnalisée, le script crée une variable de séquence de Yes
tâches personnalisée TS-UserPressedButton avec la valeur . Vous pouvez ensuite utiliser cette variable de séquence de tâches dans d’autres scripts ou comme condition pour d’autres étapes de séquence de tâches.