IProgressUI::ShowMessageEx, méthode

À partir 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 elle comprend é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ées : BSTR

Qualificateurs : [in]

Texte affiché dans le corps de la boîte de message.

pszCaption

Type de données : BSTR

Qualificateurs : [in]

Texte affiché dans l’en-tête Windows de MessageBox.

uType

Type de données : ULONG

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ées : INT

Qualificateurs : [out]

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

Valeurs retournées

HRESULTCode. Les valeurs possibles incluent, mais ne sont pas limitées à, la valeur suivante. Aucune valeur n’est HRESULT retournée qui est spécifique à cette méthode.

S_OK
S_OK

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 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 pour d’autres étapes de la séquence de tâches.

Voir aussi