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 entière, pResult.

Syntaxe

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

Paramètres

pszText

Type de donnéesBSTR

Qualificatifs : [dans]

Texte affiché dans le corps de la zone de message.

pszCaption

Type de donnéesBSTR

Qualificatifs : [dans]

Le texte affiché dans l’en-tête de la fenêtre de la boîte de message.

uType

Type de donnéesULONG

Qualificatifs : [dans]

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

Qualifications : [out]

La valeur de cette variable est une valeur de retour de boîte de message Windows standard.

Valeurs de retour

Un HRESULT code. Les valeurs possibles incluent, sans toutefois s’y limiter, la valeur suivante. Aucune valeur spécifique à cette méthode n’est HRESULT renvoyée.

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 semblable à celui-ci dans l’étape Exécuter un 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 tâches personnalisée TS-UserPressedButton avec la valeur Yes. Vous pouvez ensuite utiliser cette variable de séquence de tâches dans d’autres scripts ou en tant que condition sur d’autres étapes de séquence de tâches.

Voir aussi

  • Last updated on