Méthode IProgressUI::ShowMessageEx

  • Article

À 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 Yestâ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.

Voir aussi